WDFDEVICE_INIT estrutura

[Aplica-se a KMDF e UMDF]

A estrutura WDFDEVICE_INIT é uma estrutura opaca que é definida e alocada pela estrutura.

Sintaxe

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

Membros

Os drivers de função e filtro recebem um ponteiro para essa estrutura como entrada para um EvtDriverDeviceAdd função de retorno de chamada ou como um valor de retorno de WdfControlDeviceInitAllocate.

Os drivers de barramento recebem um ponteiro de estrutura como entrada para uma função de retorno de chamadaEvtChildListCreateDevice ou como o valor de retorno de WdfPdoInitAllocate.

Depois que um driver recebe uma estrutura WDFDEVICE_INIT, ele passa o ponteiro da estrutura para as funções de inicialização. Essas funções usam a estrutura WDFDEVICE_INIT para armazenar informações que a estrutura usa para criar um objeto de dispositivo da estrutura.

Para encontrar documentação sobre métodos de inicialização de dispositivos, consulte cabeçalho wdfdevice.h.

Depois de chamar as funções de inicialização, o driver deve chamar WdfDeviceCreate para criar o objeto de dispositivo da estrutura.

Se o driver recebeu a estrutura WDFDEVICE_INIT de uma chamada para WdfPdoInitAllocate ou WdfControlDeviceInitAllocate, e se o driver receber um erro ao chamar uma função de inicialização, o driver deverá chamar WdfDeviceInitFree em vez de WdfDeviceCreate.

Seu driver não deve chamar WdfDeviceInitFree após uma chamada bem-sucedida para WdfDeviceCreate.

A estrutura WDFDEVICE_INIT está disponível na versão 1.0 e versões posteriores do KMDF.

Requerimentos