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)

Weitere Informationen

IWiaMiniDrv

IWiaMiniDrv::d rvGetCapabilities

IWiaMiniDrv::d rvWriteItemProperties