WIA_DEV_CAP-Struktur (wia_xp.h)

  • Artikel

Anwendungen verwenden die WIA_DEV_CAP-Struktur , um Gerätefunktionen aufzulisten. Eine Gerätefunktion wird durch ein Ereignis oder einen Befehl definiert, der vom Gerät unterstützt wird. Weitere Informationen finden Sie unter IEnumWIA_DEV_CAPS.

Syntax

typedef struct _WIA_DEV_CAP {
  GUID  guid;
  ULONG ulFlags;
  BSTR  bstrName;
  BSTR  bstrDescription;
  BSTR  bstrIcon;
  BSTR  bstrCommandline;
} WIA_DEV_CAP, *PWIA_DEV_CAP, WIA_EVENT_HANDLER, *PWIA_EVENT_HANDLER;

Member

guid

Typ: GUID

Gibt eine GUID an, die die Gerätefunktion identifiziert. Dieser Member kann auf jeden der werte festgelegt werden, die unter WIA-Gerätebefehle oder WIA-Ereignisbezeichner angegeben sind.

ulFlags

Typ: ULONG

Wird beim Aufzählen von Ereignishandlern verwendet. Die möglichen Werte sind in dieser Tabelle aufgeführt.

Wert BESCHREIBUNG
WIA_IS_DEFAULT_HANDLER Der derzeit registrierte Handler sollte verwendet werden. Dies ist der einzige gültige Wert beim Aufzählen von Ereignishandlern. Es ist kein gültiger Wert beim Auflisten von Ereignisfunktionen eines Geräts.
WIA_ACTION_EVENT Das Ereignis hat den Aktionstyp, sodass Programme, die apIs für die persistente Registrierung verwenden, IWiaDevMgr::RegisterEventCallbackProgram und IWiaDevMgr::RegisterEventCallbackCLSID, empfangen können.
WIA_NOTIFICATION_EVENT Das Ereignis hat den Benachrichtigungstyp, sodass Programme, die die Laufzeitregistrierungsfunktion IWiaDevMgr::RegisterEventCallbackInterface verwenden, es empfangen können.

bstrName

Typ: BSTR

Gibt eine Zeichenfolge an, die eine Kurzversion des Funktionsnamens enthält.

bstrDescription

Typ: BSTR

Gibt eine Zeichenfolge an, die eine Beschreibung der Funktion enthält, die dem Benutzer angezeigt wird.

bstrIcon

Typ: BSTR

Gibt eine Zeichenfolge an, die den Speicherort und die Ressourcen-ID des Symbols darstellt, das diese Funktion oder diesen Handler darstellt. Die Zeichenfolge muss die folgende Form aufweisen: drive:\path\module,n, wobei n die negierte Ressourcen-ID des Symbols ist (d. a. wenn die Ressourcen-ID des Symbols 100 ist, dann ist n -100).

bstrCommandline

Typ: BSTR

Gibt eine Zeichenfolge an, die Befehlszeilenargumente darstellt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile wia_xp.h (wia.h einschließen)