struttura WIA_DEV_CAP (wia_xp.h)

Le applicazioni usano la struttura WIA_DEV_CAP per enumerare le funzionalità del dispositivo. Una funzionalità del dispositivo è definita da un evento o un comando supportato dal dispositivo. Per altre informazioni, vedere IEnumWIA_DEV_CAPS.

Sintassi

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;

Members

guid

Tipo: GUID

Specifica un GUID che identifica la funzionalità del dispositivo. Questo membro può essere impostato su uno dei valori specificati in Comandi del dispositivo WIA o identificatori di evento WIA.

ulFlags

Tipo: ULONG

Usato durante l'enumerazione dei gestori eventi. I valori possibili sono elencati in questa tabella.

Valore	Descrizione
WIA_IS_DEFAULT_HANDLER	Il gestore attualmente registrato deve essere usato. Si tratta dell'unico valore valido durante l'enumerazione dei gestori eventi. Non è un valore valido durante l'enumerazione delle funzionalità degli eventi di un dispositivo.
WIA_ACTION_EVENT	L'evento è del tipo di azione, quindi i programmi che usano API di registrazione persistente, IWiaDevMgr::RegisterEventCallbackProgram e IWiaDevMgr::RegisterEventCallbackCLSID, possono riceverlo.
WIA_NOTIFICATION_EVENT	L'evento è del tipo di notifica, quindi i programmi che usano la funzione di registrazione del runtime, IWiaDevMgr::RegisterEventCallbackInterface, possono riceverlo.

bstrName

Tipo: BSTR

Specifica una stringa contenente una versione breve del nome della funzionalità.

bstrDescription

Tipo: BSTR

Specifica una stringa contenente una descrizione della funzionalità visualizzata all'utente.

bstrIcon

Tipo: BSTR

Specifica una stringa che rappresenta la posizione e l'ID risorsa dell'icona che rappresenta questa funzionalità o gestore. La stringa deve essere del modulo seguente: drive:\path\module,n, dove n è l'ID risorsa negata dell'icona, ovvero se l'ID risorsa dell'icona è 100, n è -100.

bstrCommandline

Tipo: BSTR

Specifica una stringa che rappresenta gli argomenti della riga di comando.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	wia_xp.h (includere Wia.h)