Função NetAdapterCreate (netadapter.h)

Artigo
02/07/2025

Cria um objeto NETADAPTER.

Sintaxe

NTSTATUS NetAdapterCreate(
  [_In_]     NETADAPTER_INIT       *AdapterInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *AdapterAttributes,
  [_Out_]    NETADAPTER            *Adapter
);

Parâmetros

[_In_] AdapterInit

Um ponteiro para uma estrutura de NETADAPTER_INIT que o driver cliente recebeu anteriormente de uma chamada para NetAdapterInitAllocate.

[_In_opt_] AdapterAttributes

Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador. O ParentObject da estrutura deve ser NULL. O parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Adapter

Um ponteiro para um local que recebe um identificador para o novo objeto NETADAPTER.

Valor de retorno

A função retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função poderá retornar um código de erro NTSTATUS apropriado.

Observações

Depois de chamar WdfDeviceCreate, o cliente normalmente chama NetAdapterCreate de dentro de sua rotina de EvtDriverDeviceAdd.

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

O objeto NETADAPTER é um objeto WDF padrão. A estrutura gerencia sua exclusão, que ocorre quando o WDFDEVICE pai é excluído.

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

Compartilhar via