Función NetRxQueueCreate (netrxqueue.h)

Crea un objeto de cola de recepción neto.

Sintaxis

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

Puntero a la estructura NETRXQUEUE_INIT que el controlador cliente recibió en su función de devolución de llamada EVT_NET_ADAPTER_CREATE_RXQUEUE.

[_In_opt_] RxQueueAttributes

Puntero a la estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada e inicializada. Este parámetro es opcional y puede ser WDF_NO_OBJECT_ATTRIBUTES. Sin embargo, si el controlador cliente proporciona este parámetro, el campo ParentObject debe ser NULL.

[_In_] Configuration

Puntero a una estructura de NET_PACKET_QUEUE_CONFIG asignada por el autor de la llamada.

[_Out_] PacketQueue

Puntero a una ubicación que recibe un identificador para el nuevo objeto de cola de recepción de red.

Valor devuelto

Esta función devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función puede devolver un código de error NTSTATUS adecuado.

Observaciones

El cliente llama a NetRxQueueCreate desde su función de devolución de llamada de evento EVT_NET_ADAPTER_CREATE_RXQUEUE. Para obtener información sobre cómo asignar espacio de contexto al nuevo objeto, vea Espacio de contexto de objetos de marco.

El objeto NETPACKETQUEUE es un objeto WDF estándar. El marco administra su eliminación, que se produce cuando se elimina el objeto PRIMARIO NETADAPTER.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.27
versión mínima de UMDF	2.33
encabezado de	netrxqueue.h (include netadaptercx.h)
biblioteca de	NetAdapterCxStub.lib
irQL	PASSIVE_LEVEL