WDFDEVICE_INIT struttura

[Si applica a KMDF e UMDF]

La WDFDEVICE_INIT struttura è 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 una funzione di callback EvtDriverDeviceAdd o come valore restituito da WdfControlDeviceInitAllocate.

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

Dopo che un driver riceve una 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 la documentazione relativa ai 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 del framework.

Se il driver ha ricevuto la struttura 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 WDFDEVICE_INIT è disponibile nella versione 1.0 e versioni successive di KMDF.

Requisiti

Intestazione

Wdftypes.h (include Wdftypes.h)