EVT_NET_ADAPTER_CREATE_RXQUEUE funzione di callback (netadapter.h)

Implementazione del driver client della funzione di callback dell'evento EvtNetAdapterCreateRxQueue 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 NetAdapterCreate.

[_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 codice di errore NTSTATUS appropriato.

Commenti

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 NetRxQueueCreate per allocare una coda. Se NetRxQueueCreate ha esito negativo, la funzione di callback EvtNetAdapterCreateRxQueue 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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.29
Intestazione	netadapter.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL