estrutura WDFDEVICE_INIT

[Aplica-se a KMDF e UMDF]

A estrutura WDFDEVICE_INIT é uma estrutura opaca 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 chamadaEvtDriverDeviceAddou como um valor retornado de WdfControlDeviceInitAllocate.

Os motoristas de barramento recebem um ponteiro de estrutura como entrada para uma função de retorno de chamadaEvtChildListCreateDeviceou como o valor retornado 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 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 WdfControlDeviceInitAllocatee se o driver receber um erro ao chamar uma função de inicialização, o driver deve chamar WdfDeviceInitFree em vez de WdfDeviceCreate.

O 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