struttura WIA_DEV_CAP_DRV (wiamindr_lh.h)
La struttura WIA_DEV_CAP_DRV viene usata per enumerare le funzionalità del dispositivo. Una funzionalità del dispositivo è definita da un evento o un comando supportato dal dispositivo.
Sintassi
typedef struct _WIA_DEV_CAP_DRV {
GUID *guid;
ULONG ulFlags;
LPOLESTR wszName;
LPOLESTR wszDescription;
LPOLESTR wszIcon;
} WIA_DEV_CAP_DRV, *PWIA_DEV_CAP_DRV;
Members
guid
Punta a un GUID che identifica la funzionalità del dispositivo. Questo membro può essere impostato su uno dei valori specificati per i comandi del dispositivo WIA (comandi WIA_CMD_XXX) o identificatori di evento WIA (identificatori di evento WIA_EVENT_XXX). Per altre informazioni, vedere Comandi del dispositivo WIA.
Il driver può definire il GUID della propria funzionalità che può inviare al dispositivo. Un'applicazione deve avere conoscenze specifiche su tale funzionalità per poter rispondere alla nuova funzionalità, tuttavia. Un'applicazione riconosce normalmente solo i GUID e i COMANDI WIA standard (WIA_CMD_XXX e WIA_EVENT_XXX).
ulFlags
Specifica il tipo di evento. Questo membro può essere impostato su uno o entrambi i seguenti:
| Contrassegno | Significato |
|---|---|
| WIA_ACTION_EVENT | L'applicazione può registrare l'azione per l'evento specificato usando i metodi IWiaDevMgr::RegisterEventCallbackProgram e IwiaDevMgr::RegisterEventCallbackCLSID. Un evento di azione avvia l'applicazione registrata per gestire tale evento. |
| WIA_NOTIFICATION_EVENT | L'applicazione può registrarsi per la notifica all'evento specificato usando il metodo IwiaDevMgr::RegisterEventCallbackInterface . Un evento di notifica viene inviato solo alle applicazioni già in esecuzione. |
wszName
Specifica una stringa contenente una versione breve del nome della funzionalità.
wszDescription
Specifica una stringa contenente la versione del nome della funzionalità che può essere visualizzata all'utente.
wszIcon
Specifica una stringa contenente il nome dell'icona per questa funzionalità. L'icona può essere visualizzata all'utente .
Commenti
Il servizio WIA chiama la funzione IWiaMiniDrv::d rvGetCapabilities del minidriver per compilare i membri di una struttura WIA_DEV_CAP_DRV.
Quando un driver enumera i gestori eventi, l'unico valore valido è WIA_IS_DEFAULT_HANDLER; che indica che il gestore attualmente registrato deve essere usato.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | wiamindr_lh.h (includere Wiamindr.h) |