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

La implementación del controlador de cliente de la función de devolución de llamada de eventos EvtNetAdapterCreateTxQueue que configura una cola de transmisión (Tx).

Sintaxis

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

NTSTATUS EvtNetAdapterCreateTxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETTXQUEUE_INIT *TxQueueInit
)
{...}

Parámetros

[_In_] Adapter

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

[_Inout_] TxQueueInit

Puntero a una estructura de NETTXQUEUE_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 de EVT_NET_ADAPTER_CREATE_TXQUEUE , el controlador cliente debe llamar a NetAdapterCreate.

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

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

NetAdapterCx llama a EvtNetAdapterCreateTxQueue 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