Compartilhar via


Função NetAdapterInitAllocate (netadapter.h)

A função NetAdapterInitAllocate aloca uma estrutura NETADAPTER_INIT que um driver cliente usa ao criar um novo objeto NETADAPTER.

Sintaxe

NETADAPTER_INIT * NetAdapterInitAllocate(
  [_In_] WDFDEVICE Device
);

Parâmetros

[_In_] Device

Um identificador para um objeto de dispositivo de estrutura.

Retornar valor

Retorna um ponteiro para uma estrutura de NETADAPTER_INIT alocada por estrutura se a operação for bem-sucedida. Caso contrário, essa função retornará NULL.

Importante

Se um driver de cliente receber uma estrutura NETADAPTER_INIT de uma chamada bem-sucedida para essa função, o driver sempre deverá chamar NetAdapterInitFree para desalocá-la, independentemente do resultado de NetAdapterCreate.

Comentários

Um driver de cliente chama NetAdapterInitAllocate para obter uma estrutura NETADAPTER_INIT que ele pode passar para NetAdapterCreate.

Depois que NetAdapterInitAllocate for bem-sucedido, os drivers de cliente poderão, opcionalmente, chamar as funções NetAdapterInitSetXxx para definir outros atributos de inicialização para o NETADAPTER.

Para obter um exemplo de código de criação de um NETADAPTER, consulte Inicialização do dispositivo.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.27
Versão mínima do UMDF 2.33
Cabeçalho netadapter.h (inclua netadaptercx.h)
Biblioteca netadaptercxstub.lib
IRQL PASSIVE_LEVEL

Confira também

Inicialização do dispositivo

NetAdapterCreate

NetAdapterInitFree