WDFDEVICE_INIT Struktur

[Gilt für KMDF und UMDF]

Die WDFDEVICE_INIT-Struktur ist eine undurchsichtige Struktur, die vom Framework definiert und zugeordnet wird.

Syntax

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

Mitglieder---

Funktions- und Filtertreiber erhalten einen Zeiger auf diese Struktur als Eingabe auf eine EvtDriverDeviceAdd-Rückruffunktion oder als Rückgabewert von WdfControlDeviceInitAllocate.

Bustreiber erhalten einen Strukturzeiger als Eingabe auf eine EvtChildListCreateDevice-Rückruffunktion oder als Rückgabewert von WdfPdoInitAllocate.

Nachdem ein Treiber eine WDFDEVICE_INIT-Struktur empfangen hat, übergibt er den Strukturzeiger an Initialisierungsfunktionen. Diese Funktionen verwenden die WDFDEVICE_INIT-Struktur , um Informationen zu speichern, die das Framework zum Erstellen eines Framework-Geräteobjekts verwendet.

Eine Dokumentation für Geräteinitialisierungsmethoden finden Sie unter wdfdevice.h header.

Nach dem Aufrufen der Initialisierungsfunktionen muss der Treiber WdfDeviceCreate aufrufen, um das Framework-Geräteobjekt zu erstellen.

Wenn Ihr Treiber die WDFDEVICE_INIT-Struktur von einem Aufruf von WdfPdoInitAllocate oder WdfControlDeviceInitAllocate erhalten hat und der Treiber eine Fehlermeldung vom Aufrufen einer Initialisierungsfunktion erhält, muss der Treiber WdfDeviceInitFree anstelle von WdfDeviceCreate aufrufen.

Ihr Treiber darf WdfDeviceInitFree nach einem erfolgreichen Aufruf von WdfDeviceCreate nicht aufrufen.

Die WDFDEVICE_INIT-Struktur ist in Version 1.0 und höheren Versionen von KMDF verfügbar.

Anforderungen

Header

Wdftypes.h (einschließen von Wdftypes.h)