IWiaMiniDrv::d rvGetCapabilities-Methode (wiamindr_lh.h)
Die IWiaMiniDrv::d rvGetCapabilities-Methode gibt ein Array von Ereignissen und Befehlen zurück, die von einem Gerät unterstützt werden.
Syntax
HRESULT drvGetCapabilities(
BYTE *__MIDL__IWiaMiniDrv0048,
LONG __MIDL__IWiaMiniDrv0049,
LONG *__MIDL__IWiaMiniDrv0050,
WIA_DEV_CAP_DRV **__MIDL__IWiaMiniDrv0051,
LONG *__MIDL__IWiaMiniDrv0052
);
Parameter
__MIDL__IWiaMiniDrv0048
lFlags [in]
Gibt an, ob das Array, auf das ppCapabilites verweist, aus Befehlen, Ereignissen oder beidem besteht. Bei diesem Parameter kann es sich um eines der folgenden Flags oder um beide flags handeln, die durch einen OR-Operator kombiniert werden.
| Flag | Beschreibung |
|---|---|
| WIA_DEVICE_COMMANDS | Das Array besteht aus Gerätebefehlen. |
| WIA_DEVICE_EVENTS | Das Array besteht aus Geräteereignissen. |
__MIDL__IWiaMiniDrv0049
pWiasContext [in]
Zeiger auf einen WIA-Elementkontext.
__MIDL__IWiaMiniDrv0050
pcelt [out]
Zeigt auf einen Speicherspeicherort, der die Anzahl der Elemente im Array empfängt, auf die der ppCapabilities-Parameter verweist.
__MIDL__IWiaMiniDrv0051
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 null. Andernfalls wird ein minidriverspezifischer Fehlercode an der Stelle gespeichert, auf die dieser Parameter verweist.
__MIDL__IWiaMiniDrv0052
ppCapabilities [out, optional]
Verweist auf einen Speicherspeicherort, der die Adresse des ersten Elements eines Arrays von WIA_DEV_CAP_DRV Strukturen empfängt, die die GUIDs von Ereignissen und Befehlen enthalten, die vom Gerät unterstützt werden.
Rückgabewert
Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den plDevErrVal verweist. Wenn die Methode fehlschlägt, sollte sie einen standardmäßigen COM-Fehlercode zurückgeben und einen minidriver-spezifischen Fehlercodewert im Speicher platzieren, auf den plDevErrVal verweist.
Der Wert, auf den plDevErrVal verweist, kann in eine Zeichenfolge konvertiert werden, indem IWiaMiniDrv::d rvGetDeviceErrorStr aufgerufen wird.
Hinweise
Der WIA-Dienst ruft die minidriver-Methode IWiaMiniDrv::d rvGetCapabilities auf, um eine Liste der Hardwarebefehlsfunktionen und/oder Geräteereignisse abzurufen. Als Reaktion auf diesen Aufruf legt ein Minidriver ppCapabilities mit der Adresse eines Arrays von Zeigern auf GUID-Daten fest. Jede GUID entspricht einer Ereignisbenachrichtigung oder einem Gerätebefehl, der vom Imageerstellungsgerät unterstützt wird. Wenn der lFlags-Parameter auf WIA_DEVICE_COMMANDS festgelegt ist, enthält das Array von GUIDs Gerätebefehle. Wenn lFlags auf WIA_DEVICE_EVENTS festgelegt ist, enthält das Array von GUIDs Ereignisse. Wenn lFlags auf WIA_DEVICE_COMMANDS | WIA_DEVICE_EVENTS enthält das Array von GUIDs sowohl Ereignisse als auch Befehle, die in dieser Reihenfolge aufgeführt sind.
Der Wiadef.h-Header listet mehrere vordefinierte Befehle und Ereignisse auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (wiamindr.h einschließen) |