Funzione NetRxQueueCreate (netrxqueue.h)

Crea un oggetto coda di ricezione net.

Sintassi

NTSTATUS NetRxQueueCreate(
  [_Inout_]  NETRXQUEUE_INIT         *NetRxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *RxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

Parametri

[_Inout_] NetRxQueueInit

Puntatore alla struttura di NETRXQUEUE_INIT ricevuta dal driver client nella funzione di callback EVT_NET_ADAPTER_CREATE_RXQUEUE .

[_In_opt_] RxQueueAttributes

Puntatore alla struttura WDF_OBJECT_ATTRIBUTES allocata dal chiamante e inizializzata. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES. Tuttavia, se il driver client fornisce questo parametro, il campo ParentObject deve essere NULL.

[_In_] Configuration

Puntatore a una struttura NET_PACKET_QUEUE_CONFIG allocata dal chiamante.

[_Out_] PacketQueue

Puntatore a una posizione che riceve un handle per il nuovo oggetto della coda di ricezione net.

Valore restituito

Questa funzione restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione può restituire un codice di errore NTSTATUS appropriato.

Commenti

Il client chiama NetRxQueueCreate dall'interno della relativa funzione di callback degli eventi EVT_NET_ADAPTER_CREATE_RXQUEUE . Per informazioni sull'assegnazione dello spazio di contesto al nuovo oggetto, vedere Framework Object Context Space.

L'oggetto NETPACKETQUEUE è un oggetto WDF standard. Il framework gestisce l'eliminazione, che si verifica quando l'oggetto NETADAPTER padre viene eliminato.

Requisiti