Função NetRxQueueCreate (netrxqueue.h)

Artigo
02/07/2025

Cria um objeto de fila de recebimento de rede.

Sintaxe

NTSTATUS NetRxQueueCreate(
  [_Inout_]  NETRXQUEUE_INIT         *NetRxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *RxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

Parâmetros

[_Inout_] NetRxQueueInit

Um ponteiro para a estrutura de NETRXQUEUE_INIT que o driver cliente recebeu em sua função de retorno de chamada EVT_NET_ADAPTER_CREATE_RXQUEUE.

[_In_opt_] RxQueueAttributes

Um ponteiro para a estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador e inicializada. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES. No entanto, se o driver cliente fornecer esse parâmetro, o campo ParentObject deverá ser NULL.

[_In_] Configuration

Um ponteiro para uma estrutura de NET_PACKET_QUEUE_CONFIG alocada pelo chamador.

[_Out_] PacketQueue

Um ponteiro para um local que recebe um identificador para o novo objeto de fila de recebimento de rede.

Valor de retorno

Essa 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

O cliente chama NetRxQueueCreate de dentro de sua função de retorno de chamada de evento EVT_NET_ADAPTER_CREATE_RXQUEUE. Para obter informações sobre como atribuir espaço de contexto ao novo objeto, consulte Espaço de Contexto do Objeto framework.

O objeto NETPACKETQUEUE é um objeto WDF padrão. A estrutura gerencia sua exclusão, que ocorre quando o objeto NETADAPTER 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	netrxqueue.h (inclua netadaptercx.h)
biblioteca	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Compartilhar via