WIA_DEV_CAP_DRV Struktur (wiamindr_lh.h)
Die WIA_DEV_CAP_DRV Struktur wird zum Aufzählen von Gerätefunktionen verwendet. Eine Gerätefunktion wird durch ein Ereignis oder einen Befehl definiert, das vom Gerät unterstützt wird.
Syntax
typedef struct _WIA_DEV_CAP_DRV {
GUID *guid;
ULONG ulFlags;
LPOLESTR wszName;
LPOLESTR wszDescription;
LPOLESTR wszIcon;
} WIA_DEV_CAP_DRV, *PWIA_DEV_CAP_DRV;
Angehörige
guid
Verweist auf eine GUID, die die Gerätefunktion identifiziert. Dieses Element kann auf alle werte festgelegt werden, die für WIA-Gerätebefehle (WIA_CMD_XXX--Befehle) oder WIA-Ereignisbezeichner (WIA_EVENT_XXX Ereignisbezeichner) angegeben werden. Weitere Informationen finden Sie unter WIA Device Commands.
Der Treiber kann eine eigene Funktions-GUID definieren, die er an das Gerät senden kann. Eine Anwendung müsste spezifische Kenntnisse über diese Funktion haben, damit sie jedoch auf die neue Funktion reagieren kann. Eine Anwendung erkennt normalerweise nur die standardmäßigen WIA-Befehls- und Ereignis-GUIDs (WIA_CMD_XXX und WIA_EVENT_XXX).
ulFlags
Gibt den Ereignistyp an. Dieses Element kann auf einen oder beide der folgenden Elemente festgelegt werden:
| Flagge | Bedeutung |
|---|---|
| WIA_ACTION_EVENT | Die Anwendung kann die Aktion für das angegebene Ereignis mithilfe der IWiaDevMgr::RegisterEventCallbackProgram und IwiaDevMgr::RegisterEventCallbackCLSID Methoden registrieren. Ein Aktionsereignis startet die Anwendung, die für die Behandlung eines solchen Ereignisses registriert ist. |
| WIA_NOTIFICATION_EVENT | Die Anwendung kann sich mithilfe der IwiaDevMgr::RegisterEventCallbackInterface-Methode für Benachrichtigungen registrieren. Ein Benachrichtigungsereignis wird nur an Anwendungen gesendet, die bereits ausgeführt werden. |
wszName
Gibt eine Zeichenfolge an, die eine kurze Version des Funktionsnamens enthält.
wszDescription
Gibt eine Zeichenfolge an, die die Version des Funktionsnamens enthält, die dem Benutzer angezeigt werden kann.
wszIcon
Gibt eine Zeichenfolge an, die den Namen des Symbols für diese Funktion enthält. Das Symbol kann dem Benutzer angezeigt werden.
Bemerkungen
Der WIA-Dienst ruft die IWiaMiniDrv::d rvGetCapabilities-Funktion des Minidrivers auf, um die Elemente einer WIA_DEV_CAP_DRV Struktur auszufüllen.
Wenn ein Treiber Ereignishandler aufzählt, ist der einzige gültige Wert WIA_IS_DEFAULT_HANDLER; das angibt, dass der aktuell registrierte Handler verwendet werden soll.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | wiamindr_lh.h (include Wiamindr.h) |