NetTxQueueCreate 関数 (nettxqueue.h)
ネット送信キュー オブジェクトを作成します。
構文
NTSTATUS NetTxQueueCreate(
[_Inout_] NETTXQUEUE_INIT *NetTxQueueInit,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *TxQueueAttributes,
[_In_] NET_PACKET_QUEUE_CONFIG *Configuration,
[_Out_] NETPACKETQUEUE *PacketQueue
);
パラメーター
[_Inout_] NetTxQueueInit
クライアント ドライバーがEVT_NET_ADAPTER_CREATE_TXQUEUEで受信したNETTXQUEUE_INIT構造体へのポインター。
[_In_opt_] TxQueueAttributes
初期化された呼び出し元によって割り当てられた WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、 WDF_NO_OBJECT_ATTRIBUTESできます。 ただし、クライアント ドライバーがこのパラメーターを指定する場合、 ParentObject フィールドは NULL である必要があります。
[_In_] Configuration
呼び出し元によって割り当てられた NET_PACKET_QUEUE_CONFIG 構造体へのポインター。
[_Out_] PacketQueue
新しいネット送信キュー オブジェクトへのハンドルを受け取る場所へのポインター。
戻り値
この関数は、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、この関数は適切な NTSTATUS エラー コードを返す場合があります。
注釈
クライアントは、EVT_NET_ADAPTER_CREATE_TXQUEUE イベント コールバック関数内から NetTxQueueCreate を呼び出します。 新しいオブジェクトにコンテキスト領域を割り当てる方法については、「 Framework オブジェクト コンテキスト空間」を参照してください。
NETPACKETQUEUE オブジェクトは、標準の WDF オブジェクトです。 フレームワークは、その削除を管理します。これは、親 NETADAPTER オブジェクトが削除されたときに発生します。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
最小 KMDF バージョン | 1.27 |
最小 UMDF バージョン | 2.33 |
Header | nettxqueue.h (netadaptercx.h を含む) |
IRQL | PASSIVE_LEVEL |