control_image_sourceT_control_image_sourceControlImageSourceControlImageSourcecontrol_image_source (Operator)
Name
control_image_sourceT_control_image_sourceControlImageSourceControlImageSourcecontrol_image_source — Steuern von Aktionen, die für Bildquellen verfügbar sind.
Signatur
void ControlImageSource(const HTuple& ImageSourceHandle, const HTuple& Action, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Result)
HTuple HImageSource::ControlImageSource(const HString& Action, const HTuple& GenParamName, const HTuple& GenParamValue) const
HTuple HImageSource::ControlImageSource(const char* Action, const HTuple& GenParamName, const HTuple& GenParamValue) const
HTuple HImageSource::ControlImageSource(const wchar_t* Action, const HTuple& GenParamName, const HTuple& GenParamValue) const
(
Nur Windows)
Beschreibung
control_image_sourcecontrol_image_sourceControlImageSourceControlImageSourcecontrol_image_source initiiert Aktionen für die in
ImageSourceHandleImageSourceHandleImageSourceHandleimageSourceHandleimage_source_handle festgelegte Bildquelle. Falls eine Aktion
einen Wert liefert wird er in ResultResultResultresultresult zurückgegeben.
Die gewünschte Aktion wird in ActionActionActionactionaction festgelegt. Aktionen können
global sein, oder nur die individuellen Module der Bildquelle betreffen.
Manche Aktionen sind vom Verbindungszustand der Bildquelle abhängig.
Die Optionen für ActionActionActionactionaction, die für jede Bildquelle verfügbar sind,
sind:
- 'enumerate_groups'"enumerate_groups""enumerate_groups""enumerate_groups""enumerate_groups"
Gibt die Namen aller Parametergruppen
zurück. Wenn 'enumerate_groups'"enumerate_groups""enumerate_groups""enumerate_groups""enumerate_groups" abgefragt wird müssen die
generischen Parameter GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value
leer bleiben.
- 'enumerate_params'"enumerate_params""enumerate_params""enumerate_params""enumerate_params"
-
Gibt alle Parameter zurück, die
in der in GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value gesetzten Gruppe verfügbar sind.
Werden keine generischen Parameter gesetzt, werden
GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name = 'group'"group""group""group""group" und
GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value = 'device'"device""device""device""device" standardmäßig angenommen.
'group'"group""group""group""group" ist die einige Option für GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name.
Die Parametergruppe, der der Parameter zugeordnet ist,
wird in GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value festgelegt, indem eine dieser Optionen
gesetzt wird:
-
'image_source'"image_source""image_source""image_source""image_source",
-
'plugin'"plugin""plugin""plugin""plugin",
-
'interface'"interface""interface""interface""interface",
-
'local_device'"local_device""local_device""local_device""local_device",
-
'device'"device""device""device""device",
-
'stream'"stream""stream""stream""stream".
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ImageSourceHandleImageSourceHandleImageSourceHandleimageSourceHandleimage_source_handle (input_control) image_source → HImageSource, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Bildquellen-Handle.
ActionActionActionactionaction (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Auszuführende Aktion.
Default:
'enumerate_params'
"enumerate_params"
"enumerate_params"
"enumerate_params"
"enumerate_params"
Wertevorschläge:
'enumerate_params'"enumerate_params""enumerate_params""enumerate_params""enumerate_params", 'enumerate_groups'"enumerate_groups""enumerate_groups""enumerate_groups""enumerate_groups"
GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name-array → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Generischer Parametername.
Default:
[]
Wertevorschläge:
'group'"group""group""group""group"
GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.value-array → HTupleSequence[Union[int, float, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Generischer Parameterwert.
Default:
[]
Wertevorschläge:
'image_source'"image_source""image_source""image_source""image_source", 'plugin'"plugin""plugin""plugin""plugin", 'interface'"interface""interface""interface""interface", 'local_device'"local_device""local_device""local_device""local_device", 'device'"device""device""device""device", 'stream'"stream""stream""stream""stream"
ResultResultResultresultresult (output_control) string-array → HTupleSequence[HTupleElementType]HTupleHtuple (string / real / integer / handle) (string / double / int / long / HHandle) (HString / double / Hlong / HHandle) (char* / double / Hlong / handle)
Ergebniswert der Aktion, falls vorhanden.
Ergebnis
Sind die Parameterwerte korrekt, gibt control_image_sourcecontrol_image_sourceControlImageSourceControlImageSourcecontrol_image_source
den Wert 2 (
H_MSG_TRUE)
zurück.
Andernfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
query_image_sourcesquery_image_sourcesQueryImageSourcesQueryImageSourcesquery_image_sources,
create_image_sourcecreate_image_sourceCreateImageSourceCreateImageSourcecreate_image_source,
connect_image_sourceconnect_image_sourceConnectImageSourceConnectImageSourceconnect_image_source
Nachfolger
disconnect_image_sourcedisconnect_image_sourceDisconnectImageSourceDisconnectImageSourcedisconnect_image_source
Siehe auch
set_image_source_paramset_image_source_paramSetImageSourceParamSetImageSourceParamset_image_source_param,
get_image_source_paramget_image_source_paramGetImageSourceParamGetImageSourceParamget_image_source_param
Modul
Foundation