EVT_NET_ADAPTER_CREATE_TXQUEUE funzione di callback (netadapter.h)

  • Articolo

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

[_Inout_] TxQueueInit

Puntatore a una struttura NETTXQUEUE_INIT allocata 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(stato) equivale a TRUE. In caso contrario, un codice di errore NTSTATUS appropriato.

Commenti

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

Requisiti

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