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.
};

Elemente

Funktions- und Filtertreiber erhalten einen Zeiger auf diese Struktur als Eingabe für 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 empfängt, ü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.

Informationen zur Dokumentation zu Methoden für die Geräteinitialisierung finden Sie unter wdfdevice.h header.

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

Wenn Ihr Treiber die WDFDEVICE_INIT Struktur von einem Aufruf an WdfPdoInitAllocate oder WdfControlDeviceInitAllocateempfangen hat und wenn der Treiber einen Fehler vom Aufrufen einer Initialisierungsfunktion erhält, muss der Treiber WdfDeviceInitFree anstelle von WdfDeviceCreateaufrufen.

Ihr Treiber darf WdfDeviceInitFree nach einem erfolgreichen Aufruf von WdfDeviceCreatenicht aufrufen.

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

Anforderungen