WIA_DEV_CAP_DRV-Struktur (wiamindr_lh.h)
Die WIA_DEV_CAP_DRV-Struktur wird verwendet, um Gerätefunktionen aufzulisten. Eine Gerätefunktion wird durch ein Ereignis oder einen Befehl definiert, der 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;
Member
guid
Verweist auf eine GUID, die die Gerätefunktion identifiziert. Dieser Member kann auf jeden der Werte festgelegt werden, die für WIA-Gerätebefehle (WIA_CMD_XXX-Befehle ) oder WIA-Ereignisbezeichner (WIA_EVENT_XXX-Ereignisbezeichner ) angegeben sind. Weitere Informationen finden Sie unter WIA-Gerätebefehle.
Der Treiber kann eine eigene Funktions-GUID definieren, die er an das Gerät senden kann. Eine Anwendung müsste jedoch über spezifische Kenntnisse über diese Funktion verfügen, damit sie 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 Typ des Ereignisses an. Dieser Member kann auf einen oder beide der folgenden Elemente festgelegt werden:
| Flag | Bedeutung |
|---|---|
| WIA_ACTION_EVENT | Die Anwendung kann die Aktion für das angegebene Ereignis mithilfe der Methoden IWiaDevMgr::RegisterEventCallbackProgram und IwiaDevMgr::RegisterEventCallbackCLSID registrieren. Ein Aktionsereignis startet die Anwendung, die registriert ist, um ein solches Ereignis zu behandeln. |
| WIA_NOTIFICATION_EVENT | Die Anwendung kann sich mit der IwiaDevMgr::RegisterEventCallbackInterface-Methode für Benachrichtigungen für das angegebene Ereignis registrieren. Ein Benachrichtigungsereignis wird nur an Anwendungen gesendet, die bereits ausgeführt werden. |
wszName
Gibt eine Zeichenfolge an, die eine Kurzversion des Funktionsnamens enthält.
wszDescription
Gibt eine Zeichenfolge mit der Version des Funktionsnamens an, 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.
Hinweise
Der WIA-Dienst ruft die IWiaMiniDrv::d rvGetCapabilities-Funktion des Minidrivers auf, um die Member einer WIA_DEV_CAP_DRV-Struktur auszufüllen.
Wenn ein Treiber Ereignishandler aufzählt, ist der einzige gültige Wert WIA_IS_DEFAULT_HANDLER; Dies gibt an, dass der derzeit registrierte Handler verwendet werden soll.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | wiamindr_lh.h (wiamindr.h einschließen) |