EVT_NET_ADAPTER_CREATE_TXQUEUE funzione di callback (netadapter.h)

Implementazione del driver client della EvtNetAdapterCreateTxQueue funzione di callback degli eventi che configura una coda di trasmissione (Tx).

Sintassi

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

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

Parametri

[_In_] Adapter

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

[_Inout_] TxQueueInit

Puntatore a una struttura NETTXQUEUE_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_TXQUEUE, il driver client deve chiamare NetAdapterCreate.

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

In questo callback, il driver client potrebbe chiamare NetTxQueueInitGetQueueId per recuperare l'identificatore della coda di trasmissione da configurare. Successivamente, il client chiama NetTxQueueCreare per allocare una coda. Se NetTxQueueCreate ha esito negativo, il EvtNetAdapterCreateTxQueue funzione di callback deve restituire un codice di errore.

NetAdapterCx chiama EvtNetAdapterCreateTxQueue 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