WDFDEVICE_INIT struttura

[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 a una funzione EvtDriverDeviceAdd callback o come valore restituito da WdfControlDeviceInitAllocate.

I driver del bus ricevono un puntatore della struttura come input a una funzione di callback EvtChildListCreateDevice 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 informazioni usate dal framework per creare un oggetto dispositivo framework.

Per trovare la documentazione per i metodi di inizializzazione dei dispositivi, vedere l'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 di WDFDEVICE_INIT da una chiamata a WdfPdoInitAllocate o WdfControlDeviceInitAllocate e se il driver riceve un errore dalla chiamata a 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 versioni successive di KMDF.

Requisiti

Intestazione

Wdftypes.h (includere Wdftypes.h)