IWiaMiniDrv::d rvGetCapabilities-Methode (wiamindr_lh.h)
Die IWiaMiniDrv::d rvGetCapabilities Methode gibt ein Array von Ereignissen und Befehlen zurück, die ein Gerät unterstützt.
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 oder Ereignissen oder beidem besteht. Dieser Parameter kann eine der folgenden Flags oder beides sein, die von einem OR-Operator kombiniert werden.
| Flagge | 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]
Verweist auf einen Speicherspeicherort, der die Anzahl der Elemente im Array empfängt, auf die durch den ppCapabilities Parameter verwiesen wird.
__MIDL__IWiaMiniDrv0051
plDevErrVal [out]
Verweist auf einen Speicherspeicherort, der einen Statuscode für diese Methode empfängt. Wenn diese Methode S_OKzurückgibt, ist der gespeicherte Wert null. Andernfalls wird ein minidriverspezifischer Fehlercode an der Position gespeichert, auf die durch diesen Parameter verwiesen wird.
__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 das Gerät unterstützt.
Rückgabewert
Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den durch plDevErrValverwiesen wurde. Wenn die Methode fehlschlägt, sollte ein standardmäßiger COM-Fehlercode zurückgegeben und ein minidriverspezifischer Fehlercodewert im Speicher platziert werden, auf den plDevErrValverweist.
Der wert, auf den plDevErrVal verweist, kann in eine Zeichenfolge konvertiert werden, indem IWiaMiniDrv::d rvGetDeviceErrorStraufgerufen wird.
Bemerkungen
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 festgelegt ist | WIA_DEVICE_EVENTS enthält das Array von GUIDs sowohl Ereignisse als auch Befehle, die in dieser Reihenfolge aufgeführt sind.
Die Wiadef.h Header listet mehrere vordefinierte Befehle und Ereignisse auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wiamindr_lh.h (include Wiamindr.h) |