struttura WDFDEVICE_INIT

[Si applica a KMDF e UMDF]

La struttura WDFDEVICE_INIT è una struttura opaca definita e allocata dal framework.

Sintassi

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

Membri

I driver di funzione e filtro ricevono un puntatore a questa struttura come input per un EvtDriverDeviceAdd funzione di callback o come valore restituito da WdfControlDeviceInitAllocate.

I driver del bus ricevono un puntatore di struttura come input a un EvtChildListCreateDevice funzione di callback o come valore restituito da WdfPdoInitAllocate.

Dopo che un driver riceve una struttura WDFDEVICE_INIT, passa il puntatore della struttura alle funzioni di inizializzazione. Queste funzioni usano la struttura WDFDEVICE_INIT per archiviare le informazioni usate dal framework per creare un oggetto dispositivo framework.

Per trovare la documentazione per i metodi di inizializzazione dei dispositivi, vedere intestazione wdfdevice.h.

Dopo aver chiamato le funzioni di inizializzazione, il driver deve chiamare WdfDeviceCreate per creare l'oggetto dispositivo framework.

Se il driver ha ricevuto la struttura WDFDEVICE_INIT da una chiamata a WdfPdoInitAllocate o WdfControlDeviceInitAllocatee se il driver riceve un errore dalla chiamata di una funzione di inizializzazione, il driver deve chiamare WdfDeviceInitFree anziché WdfDeviceCreate.

Il driver non deve chiamare WdfDeviceInitFree dopo una chiamata riuscita a WdfDeviceCreate.

La struttura WDFDEVICE_INIT è disponibile nella versione 1.0 e successive di KMDF.

Requisiti

Header

Wdftypes.h (include Wdftypes.h)