Funzione NetRxQueueCreate (netrxqueue.h)

Crea un oggetto coda di ricezione rete.

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 NETRXQUEUE_INIT ricevuta dal driver client nella relativa funzione di callback EVT_NET_ADAPTER_CREATE_RXQUEUE.

[_In_opt_] RxQueueAttributes

Puntatore alla struttura WDF_OBJECT_ATTRIBUTES allocata e inizializzata del chiamante. 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 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.

Osservazioni

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 viene eliminato l'oggetto NETADAPTER padre.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.27
versione minima di UMDF	2.33
intestazione	netrxqueue.h (include netadaptercx.h)
libreria	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL