Metodo IWiaMiniDrv::d rvGetWiaFormatInfo (wiamindr_lh.h)
Il metodo IWiaMiniDrv::d rvGetWiaFormatInfo trova i formati di immagine e i tipi di supporto supportati dal dispositivo hardware WIA.
Sintassi
HRESULT drvGetWiaFormatInfo(
BYTE *__MIDL__IWiaMiniDrv0059,
LONG __MIDL__IWiaMiniDrv0060,
LONG *__MIDL__IWiaMiniDrv0061,
WIA_FORMAT_INFO **__MIDL__IWiaMiniDrv0062,
LONG *__MIDL__IWiaMiniDrv0063
);
Parametri
__MIDL__IWiaMiniDrv0059
lFlags [in]
Riservato.
__MIDL__IWiaMiniDrv0060
pWiasContext [in]
Puntatore a un contesto di elemento WIA.
__MIDL__IWiaMiniDrv0061
pcelt [out]
Punta a una posizione di memoria che riceverà il numero di elementi nella matrice puntata da ppwfi.
__MIDL__IWiaMiniDrv0062
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__IWiaMiniDrv0063
ppwfi [out, facoltativo]
Punta a una posizione di memoria che riceverà l'indirizzo del primo elemento di una matrice di strutture WIA_FORMAT_INFO .
Valore restituito
In caso di esito positivo, il metodo deve restituire S_OK e cancellare il valore di errore del dispositivo a cui fa riferimento plDevErrVal. Se questo metodo viene chiamato per gli elementi che non contengono dati, deve restituire E_INVALIDARG. Se il metodo ha esito negativo, deve restituire un codice di errore COM standard e inserire un valore di codice di errore specifico di minidriver nella memoria a cui punta plDevErrVal.
Il valore a cui fa riferimento plDevErrVal può essere convertito in una stringa chiamando IWiaMiniDrv::d rvGetDeviceErrorStr.
Commenti
Questo metodo crea una matrice di strutture WIA_FORMAT_INFO che descrivono i tipi di supporti e i formati di immagine supportati dal dispositivo hardware WIA. Per ogni elemento della matrice, il tipo di supporto può essere uno dei TYMED_CALLBACK, TYMED_MULTIPAGE_CALLBACK, TYMED_FILE o TYMED_MULTIPAGE_FILE. I valori tipici per il formato immagine includono WiaImgFmt_JPEG e WiaImgFmt_BMP, tra gli altri. Per altre informazioni, vedere Informazioni su TYMED e WIA_IPA_FILENAME_EXTENSION.
Il minidriver può definire una matrice globale per contenere le strutture WIA_FORMAT_INFO oppure può allocare memoria per la matrice. Il servizio WIA non libera la memoria allocata, quindi il minidriver deve archiviare un puntatore a tale memoria nel contesto dell'elemento driver. Il minidriver può quindi liberare questa memoria in una chiamata a IWiaMiniDrv::d rvFreeDrvItemContext.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamindr_lh.h (includere Wiamindr.h) |