estructura de WDFDEVICE_INIT

[Se aplica a KMDF y UMDF]

La estructura WDFDEVICE_INIT es una estructura opaca definida y asignada por el marco.

Syntax

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

Miembros---

Los controladores de función y filtro reciben un puntero a esta estructura como entrada para una función de devolución de llamada EvtDriverDeviceAdd o como un valor devuelto de WdfControlDeviceInitAllocate.

Los controladores de bus reciben un puntero de estructura como entrada para una función de devolución de llamada EvtChildListCreateDevice o como el valor devuelto de WdfPdoInitAllocate.

Una vez que un controlador recibe una estructura de WDFDEVICE_INIT , pasa el puntero de estructura a las funciones de inicialización. Estas funciones usan la estructura de WDFDEVICE_INIT para almacenar información que usa el marco para crear un objeto de dispositivo de marco.

Para buscar documentación sobre los métodos de inicialización de dispositivos, consulte el encabezado wdfdevice.h.

Después de llamar a las funciones de inicialización, el controlador debe llamar a WdfDeviceCreate para crear el objeto de dispositivo de marco.

Si el controlador recibió la estructura de WDFDEVICE_INIT de una llamada a WdfPdoInitAllocate o WdfControlDeviceInitAllocate y, si el controlador recibe un error al llamar a una función de inicialización, el controlador debe llamar a WdfDeviceInitFree en lugar de WdfDeviceCreate.

El controlador no debe llamar a WdfDeviceInitFree después de una llamada correcta a WdfDeviceCreate.

La estructura WDFDEVICE_INIT está disponible en la versión 1.0 y versiones posteriores de KMDF.

Requisitos

Encabezado

Wdftypes.h (incluya Wdftypes.h)