struttura WIA_DEV_CAP_DRV (wiamindr_lh.h)

Articolo
03/05/2024

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)

Vedi anche

Funzionalità driver

IWiaMiniDrv::d rvGetCapabilities

Condividi tramite