IWiaMiniDrv::d rvInitializeWia-Methode (wiamindr_lh.h)

Artikel
03/01/2024

Die IWiaMiniDrv::d rvInitializeWia-Methode initialisiert den Minitreiber und erstellt die Treiberelementstruktur, die das Gerät darstellt.

Syntax

HRESULT drvInitializeWia(
  BYTE        *__MIDL__IWiaMiniDrv0000,
  LONG        __MIDL__IWiaMiniDrv0001,
  BSTR        __MIDL__IWiaMiniDrv0002,
  BSTR        __MIDL__IWiaMiniDrv0003,
  IUnknown    *__MIDL__IWiaMiniDrv0004,
  IUnknown    *__MIDL__IWiaMiniDrv0005,
  IWiaDrvItem **__MIDL__IWiaMiniDrv0006,
  IUnknown    **__MIDL__IWiaMiniDrv0007,
  LONG        *__MIDL__IWiaMiniDrv0008
);

Parameter

__MIDL__IWiaMiniDrv0000

bstrDeviceID [in]

Gibt eine Zeichenfolge an, die den eindeutigen Bezeichner des Geräts enthält.

__MIDL__IWiaMiniDrv0001

bstrRootFullItemName [in]

Gibt eine Zeichenfolge an, die den vollständigen Namen des Stammelements enthält.

__MIDL__IWiaMiniDrv0002

lFlags [in]

Reserviert. Auf NULL festlegen.

__MIDL__IWiaMiniDrv0003

pIUnknownOuter [in, optional]

(Optional) Verweist auf einen Speicherspeicherort, der die Adresse einer IUnknown-Schnittstelle empfangen kann.

__MIDL__IWiaMiniDrv0004

pStiDevice [in, optional]

Verweist auf eine IStiDevice-COM-Schnittstelle.

__MIDL__IWiaMiniDrv0005

pWiasContext [in]

Zeiger auf einen WIA-Elementkontext.

__MIDL__IWiaMiniDrv0006

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__IWiaMiniDrv0007

ppIDrvItemRoot [out, optional]

Verweist auf einen Speicherspeicherort, der die Adresse einer IWiaDrvItem-Schnittstelle, der Schnittstelle des Stammelements, erhält.

__MIDL__IWiaMiniDrv0008

ppIUnknownInner [out, optional]

(Optional) Verweist auf einen Speicherspeicherort, der die Adresse einer IUnknown-Schnittstelle empfangen kann. Wenn der Minitreiber über Funktionen verfügt, auf die nicht über die IWiaMiniDrv-Schnittstelle zugegriffen werden kann, kann der Anbieter eine separate Schnittstelle auf dem Minitreiber erstellen. Dieser Parameter bietet Zugriff auf diese Funktionalität.

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

Diese Methode sollte alle privaten Strukturen initialisieren und die Treiberelementstruktur erstellen. Ausführliche Informationen zu den Schritten, die Minidriver normalerweise in dieser Methode ausführen, finden Sie unter Initialisieren des WIA-Minitreibers und Erstellen der WIA-Treiberelementstruktur.

Der WIA-Dienst ruft die IWiaMiniDrv::d rvInitializeWia-Methode als Reaktion auf den Aufruf der CreateDevice-Funktion eines Clients auf. Dies bedeutet, dass diese Methode für jede neue Clientverbindung einmal aufgerufen wird.

Wenn der Benutzer beispielsweise mit der rechten Maustaste auf ein WIA-Scannersymbol in "Mein Computer" klickt, ruft die Shell CreateDevice auf, wodurch ein Aufruf der IWiaMiniDrv::d rvInitializeWia-Methode des Minitreibers generiert wird. Wenn der Benutzer dann den WIA-Erfassungs-Assistenten ausführt, ruft er auch CreateDevice auf. Jedes Mal, wenn CreateDevice aufgerufen wird, gibt es einen entsprechenden Aufruf der IWiaMiniDrv::d rvInitializeWia-Methode auf dem Minidriver.