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.

Valor de retorno

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 cliente receber uma estrutura de 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.

Observações

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

Depois que NetAdapterInitAllocate for bem-sucedido, os drivers cliente poderão chamar opcionalmente funções de 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 de inicialização do dispositivo.

Requisitos

Requisito	Valor
da 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

Consulte também

de inicialização do dispositivo

NetAdapterCreate

NetAdapterInitFree