Metodo IWiaMiniDrv::d rvGetCapabilities (wiamindr_lh.h)
Il metodo IWiaMiniDrv::d rvGetCapabilities restituisce una matrice di eventi e comandi supportati da un dispositivo.
Sintassi
HRESULT drvGetCapabilities(
BYTE *__MIDL__IWiaMiniDrv0048,
LONG __MIDL__IWiaMiniDrv0049,
LONG *__MIDL__IWiaMiniDrv0050,
WIA_DEV_CAP_DRV **__MIDL__IWiaMiniDrv0051,
LONG *__MIDL__IWiaMiniDrv0052
);
Parametri
__MIDL__IWiaMiniDrv0048
lFlags [in]
Specifica se la matrice a cui punta ppCapabilites è costituita da comandi, eventi o entrambi. Questo parametro può essere uno dei flag seguenti o entrambi combinati da un operatore OR.
| Flag | Descrizione |
|---|---|
| WIA_DEVICE_COMMANDS | La matrice è costituita da comandi del dispositivo. |
| WIA_DEVICE_EVENTS | La matrice è costituita da eventi del dispositivo. |
__MIDL__IWiaMiniDrv0049
pWiasContext [in]
Puntatore a un contesto di elemento WIA.
__MIDL__IWiaMiniDrv0050
pcelt [out]
Punta a una posizione di memoria che riceverà il numero di elementi nella matrice a cui punta il parametro ppCapabilities .
__MIDL__IWiaMiniDrv0051
plDevErrVal [out]
Punta a una posizione di memoria che riceverà un codice di stato per questo metodo. Se questo metodo restituisce S_OK, il valore archiviato sarà zero. In caso contrario, un codice di errore specifico del minidriver verrà archiviato nella posizione a cui punta questo parametro.
__MIDL__IWiaMiniDrv0052
ppCapabilities [out, facoltativo]
Punta a una posizione di memoria che riceverà l'indirizzo del primo elemento di una matrice di strutture WIA_DEV_CAP_DRV che contengono i GUID di eventi e comandi supportati dal dispositivo.
Valore restituito
In caso di esito positivo, il metodo deve restituire S_OK e cancellare il valore di errore del dispositivo a cui punta plDevErrVal. Se il metodo ha esito negativo, deve restituire un codice di errore COM standard e inserire un valore di codice di errore specifico del minidriver nella memoria a cui punta plDevErrVal.
Il valore a cui punta plDevErrVal può essere convertito in una stringa chiamando IWiaMiniDrv::d rvGetDeviceErrorStr.
Commenti
Il servizio WIA chiama il metodo minidriver IWiaMiniDrv::d rvGetCapabilities per ottenere un elenco di funzionalità dei comandi hardware e/o eventi del dispositivo. In risposta a questa chiamata, un minidriver imposta ppCapabilities con l'indirizzo di una matrice di puntatori ai dati GUID. Ogni GUID corrisponde a una notifica degli eventi o a un comando del dispositivo supportato dal dispositivo di creazione dell'immagine. Quando il parametro lFlags è impostato su WIA_DEVICE_COMMANDS, la matrice di GUID contiene i comandi del dispositivo. Quando lFlags è impostato su WIA_DEVICE_EVENTS, la matrice di GUID contiene eventi. Se lFlags è impostato su WIA_DEVICE_COMMANDS | WIA_DEVICE_EVENTS, la matrice di GUID contiene sia eventi che comandi, elencati in tale ordine.
L'intestazione Wiadef.h elenca diversi comandi ed eventi predefiniti.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamindr_lh.h (include Wiamindr.h) |