EVT_NET_ADAPTER_CREATE_RXQUEUE función de devolución de llamada (netadapter.h)

La implementación del controlador cliente de la función de devolución de llamada de eventos EvtNetAdapterCreateRxQueue que configura una cola de recepción (Rx).

Sintaxis

EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;

NTSTATUS EvtNetAdapterCreateRxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETRXQUEUE_INIT *RxQueueInit
)
{...}

Parámetros

[_In_] Adapter

Objeto de adaptador de red que el cliente creó en una llamada anterior a NetAdapterCreate.

[_Inout_] RxQueueInit

Puntero a una estructura de NETRXQUEUE_INIT asignada por NetAdapterCx. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si la operación se realiza correctamente, la función de devolución de llamada debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE. De lo contrario, un código de error NTSTATUS adecuado.

Comentarios

Para registrar una función de devolución de llamada EVT_NET_ADAPTER_CREATE_RXQUEUE, el controlador cliente debe llamar a NetAdapterCreate.

La estructura NETRXQUEUE_INIT es una estructura opaca definida y asignada por NetAdapterCx, similar a WDFDEVICE_INIT.

En esta devolución de llamada, el controlador de cliente podría llamar a NetRxQueueInitGetQueueId para recuperar el identificador de la cola de recepción que se va a configurar. A continuación, el cliente llama a NetRxQueueCreate para asignar una cola. Si se produce un error en NetRxQueueCreate , la función de devolución de llamada EvtNetAdapterCreateRxQueue debe devolver un código de error.

NetAdapterCx llama a EvtNetAdapterCreateRxQueue al final de la secuencia de encendido.

Para obtener un ejemplo de código de implementación de esta función de devolución de llamada, consulte Transmisión y recepción de colas.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.29
Versión mínima de UMDF 2,33
Encabezado netadapter.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL