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 uma função de retorno de chamada EvtDriverDeviceAdd 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 chamada EvtChildListCreateDevice ou como o valor de retorno de WdfPdoInitAllocate.

Depois que um driver recebe uma estrutura WDFDEVICE_INIT , ele passa o ponteiro da estrutura para 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 de estrutura.

Para localizar a documentação dos métodos de inicialização do dispositivo, consulte o cabeçalho wdfdevice.h.

Depois de chamar 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.

Requisitos

Cabeçalho

Wdftypes.h (inclui Wdftypes.h)