NetRxQueueCreate 関数 (netrxqueue.h)

  • [アーティクル]

ネット受信キュー オブジェクトを作成します。

構文

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

パラメーター

[_Inout_] NetRxQueueInit

クライアント ドライバーがEVT_NET_ADAPTER_CREATE_RXQUEUEコールバック関数で受け取った NETRXQUEUE_INIT 構造体へのポインター。

[_In_opt_] RxQueueAttributes

呼び出し元によって割り当てられ、 初期化されたWDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、 WDF_NO_OBJECT_ATTRIBUTESできます。 ただし、クライアント ドライバーがこのパラメーターを指定する場合、 ParentObject フィールドは NULL である必要があります。

[_In_] Configuration

呼び出し元によって割り当てられた NET_PACKET_QUEUE_CONFIG 構造体へのポインター。

[_Out_] PacketQueue

新しい net receive queue オブジェクトへのハンドルを受け取る場所へのポインター。

戻り値

この関数は、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、この関数は適切な NTSTATUS エラー コードを返す場合があります。

注釈

クライアントは、EVT_NET_ADAPTER_CREATE_RXQUEUEイベント コールバック関数内から NetRxQueueCreate を呼び出します。 新しいオブジェクトにコンテキスト領域を割り当てる方法については、「 Framework オブジェクト コンテキスト空間」を参照してください。

NETPACKETQUEUE オブジェクトは、標準の WDF オブジェクトです。 フレームワークは、その削除を管理します。これは、親 NETADAPTER オブジェクトが削除されたときに発生します。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.27
Header netrxqueue.h (netadaptercx.h を含む)
Library NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL