IWiaMiniDrv::d rvDeviceCommand-Methode (wiamindr_lh.h)
Die IWiaMiniDrv::d rvDeviceCommand-Methode gibt einen Befehl an ein WIA-Gerät aus.
Syntax
HRESULT drvDeviceCommand(
BYTE *__MIDL__IWiaMiniDrv0043,
LONG __MIDL__IWiaMiniDrv0044,
const GUID *__MIDL__IWiaMiniDrv0045,
IWiaDrvItem **__MIDL__IWiaMiniDrv0046,
LONG *__MIDL__IWiaMiniDrv0047
);
Parameter
__MIDL__IWiaMiniDrv0043
lFlags [in]
Reserviert.
__MIDL__IWiaMiniDrv0044
pWiasContext [in]
Zeiger auf einen WIA-Elementkontext.
__MIDL__IWiaMiniDrv0045
plCommand [in]
Zeigt auf eine WIA-Befehls-GUID.
__MIDL__IWiaMiniDrv0046
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__IWiaMiniDrv0047
ppWiaDrvItem [out, optional]
Zeigt auf einen Speicherspeicherort, der einen Zeiger auf eine IWiaDrvItem-Schnittstelle empfangen kann. Weitere Informationen finden Sie weiter unten im Abschnitt "Hinweise".
Rückgabewert
Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den von plDevErrVal verwiesen wird. 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
Die Methode IWiaMiniDrv::d rvDeviceCommand wird vom WIA-Dienst aufgerufen, um einen vom WIA-Dienst oder einer Anwendung generierten Befehl für das Gerät ausstellen zu können. Der WIA-Dienst ruft nur die IWiaMiniDrv::d rvDeviceCommand-Methode für einen Befehl auf, den das Gerät in der Methode IWiaMiniDrv::d rvGetCapabilities unterstützen kann.
Der ppWiaDrvItem-Parameter sollte als optional betrachtet werden, da der Minidriver normalerweise nicht den Speicherort festgelegt, auf den er verweist. Bei bestimmten Befehlen platziert der Minidriver jedoch die Adresse eines neu erstellten Elements an der Position, auf die dieser Parameter verweist. Wenn beispielsweise der Befehl zum Aufnehmen eines Bilds ausgegeben wird (plCommand ist auf WIA_CMD_TAKE_PICTURE festgelegt), erzeugt das Gerät ein neues Image, wodurch der Minidriver ein neues Element in der Treiberelementstruktur erstellt und *ppWiaDrvItem auf die Adresse des neuen Elements festlegt. Dadurch wird der WIA-Dienst darüber informiert, dass ein neues Element erstellt wurde.
Der Minidriver kann eine Liste benutzerdefinierter Befehle enthalten, die das Gerät in der Methode IWiaMiniDrv::d rvGetCapabilities unterstützen kann.
Der WIA-Dienst schreibt keine Eigenschaften, bevor diese Methode aufgerufen wird. Wenn der Befehl auf Eigenschafteneinstellungen basiert, sollte der Minidriver IWiaMiniDrv::d rvWriteItemProperties aufrufen, bevor er den Befehl ausgibt. Beispielsweise kann der Befehl zum Aufnehmen eines Bilds , WIA_CMD_TAKE_PICTURE, von Verschlusszeit- und Blendeneinstellungen abhängen, die auf das Gerät geschrieben werden müssen, bevor der Befehl ausgegeben wird.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | wiamindr_lh.h (einschließlich Wiamindr.h) |