EVT_NET_ADAPTER_CREATE_RXQUEUE funzione di callback (netadapter.h)

Articolo
02/07/2025

Implementazione del driver client della EvtNetAdapterCreateRxQueue funzione di callback degli eventi che configura una coda di ricezione (Rx).

Sintassi

EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;

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

Parametri

[_In_] Adapter

Oggetto scheda di rete creato dal client in una chiamata precedente a NetAdapterCreare.

[_Inout_] RxQueueInit

Puntatore a una struttura NETRXQUEUE_INIT allocata da NetAdapterCx. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Se l'operazione ha esito positivo, la funzione di callback deve restituire STATUS_SUCCESS o un altro valore di stato per cui NT_SUCCESS(status) è TRUE. In caso contrario, un NTSTATUS codice di errore appropriato.

Osservazioni

Per registrare una funzione di callback EVT_NET_ADAPTER_CREATE_RXQUEUE, il driver client deve chiamare NetAdapterCreate.

La struttura NETRXQUEUE_INIT è una struttura opaca definita e allocata da NetAdapterCx, simile a WDFDEVICE_INIT.

In questo callback, il driver client potrebbe chiamare NetRxQueueInitGetQueueId per recuperare l'identificatore della coda di ricezione da configurare. Il client chiama quindi NetRxQueueCreare per allocare una coda. Se NetRxQueueCreate ha esito negativo, la EvtNetAdapterCreateRxQueue funzione di callback deve restituire un codice di errore.

NetAdapterCx chiama EvtNetAdapterCreateRxQueue alla fine della sequenza di alimentazione .

Per un esempio di codice di implementazione di questa funzione di callback, vedere Trasmettere e ricevere code.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.29
versione minima di UMDF	2.33
intestazione	netadapter.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Condividi tramite