IWiaMiniDrv::d rvGetWiaFormatInfo-Methode (wiamindr_lh.h)
Die IWiaMiniDrv::d rvGetWiaFormatInfo-Methode findet die Bildformate und Medientypen, die das WIA-Hardwaregerät unterstützt.
Syntax
HRESULT drvGetWiaFormatInfo(
BYTE *__MIDL__IWiaMiniDrv0059,
LONG __MIDL__IWiaMiniDrv0060,
LONG *__MIDL__IWiaMiniDrv0061,
WIA_FORMAT_INFO **__MIDL__IWiaMiniDrv0062,
LONG *__MIDL__IWiaMiniDrv0063
);
Parameter
__MIDL__IWiaMiniDrv0059
lFlags [in]
Reserviert.
__MIDL__IWiaMiniDrv0060
pWiasContext [in]
Zeiger auf einen WIA-Elementkontext.
__MIDL__IWiaMiniDrv0061
pcelt [out]
Zeigt auf einen Speicherspeicherort, der die Anzahl der Elemente im Array empfängt, auf die von ppwfi verwiesen wird.
__MIDL__IWiaMiniDrv0062
plDevErrVal [out]
Verweist auf einen Speicherspeicherort, der einen status Code für diese Methode erhält. Wenn diese Methode S_OK zurückgibt, ist der gespeicherte Wert 0. Andernfalls wird ein minidriverspezifischer Fehlercode an der Position gespeichert, auf die dieser Parameter verweist.
__MIDL__IWiaMiniDrv0063
ppwfi [out, optional]
Verweist auf einen Speicherspeicherort, der die Adresse des ersten Elements eines Arrays von WIA_FORMAT_INFO Strukturen empfängt.
Rückgabewert
Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den von plDevErrVal verwiesen wird. Wenn diese Methode für Elemente aufgerufen wird, die keine Daten enthalten, sollte sie E_INVALIDARG zurückgeben. Wenn die Methode fehlschlägt, sollte sie einen COM-Standardfehlercode zurückgeben und einen minidriverspezifischen Fehlercodewert im Speicher platzieren, auf den von plDevErrVal verwiesen wird.
Der Wert, auf den plDevErrVal verweist, kann in eine Zeichenfolge konvertiert werden, indem IWiaMiniDrv::d rvGetDeviceErrorStr aufgerufen wird.
Hinweise
Diese Methode erstellt ein Array von WIA_FORMAT_INFO Strukturen, die die Vom WIA-Hardwaregerät unterstützten Medientypen und Bildformate beschreiben. Für jedes Element im Array kann der Medientyp TYMED_CALLBACK, TYMED_MULTIPAGE_CALLBACK, TYMED_FILE oder TYMED_MULTIPAGE_FILE sein. Typische Werte für das Bildformat sind unter anderem WiaImgFmt_JPEG und WiaImgFmt_BMP. Weitere Informationen finden Sie unter Grundlegendes zu TYMED und WIA_IPA_FILENAME_EXTENSION.
Der Minidriver kann ein globales Array definieren, um die WIA_FORMAT_INFO-Strukturen aufzunehmen, oder er kann Arbeitsspeicher für das Array zuweisen. Der WIA-Dienst gibt den zugewiesenen Arbeitsspeicher nicht frei, sodass der Minidriver einen Zeiger auf diesen Speicher im Kontext des Treiberelements speichern sollte. Der Minidriver kann diesen Arbeitsspeicher dann in einem Aufruf von IWiaMiniDrv::d rvFreeDrvItemContext freigeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (einschließlich Wiamindr.h) |