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

I driver del bus ricevono un puntatore di 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 le 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 WDFDEVICE_INIT da una chiamata a WdfPdoInitAllocate o WdfControlDeviceInitAllocate e se il driver riceve un errore dalla chiamata di una funzione di inizializzazione, il driver deve chiamare WdfDeviceInitFree invece di 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

Intestazione

Wdftypes.h (include Wdftypes.h)