Función NetRxQueueCreate (netrxqueue.h)

Crea un objeto de cola de recepción neta.

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 de 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 de 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.

Comentarios

El cliente llama a NetRxQueueCreate desde su EVT_NET_ADAPTER_CREATE_RXQUEUE función de devolución de llamada de eventos. 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	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.27
Versión mínima de UMDF	2,33
Encabezado	netrxqueue.h (include netadaptercx.h)
Library	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL