NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED関数 (netadapter.h)

  • [アーティクル]

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED関数は、ドライバー管理の受信バッファーの割り当てと添付ファイルを指定するネット アダプターのNET_ADAPTER_RX_CAPABILITIES構造体を初期化します。

構文

void NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES      *RxCapabilities,
  [_In_]  PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer,
  [_In_]  SIZE_T                           MaximumFrameSize,
  [_In_]  SIZE_T                           MaximumNumberOfQueues
);

パラメーター

[_Out_] RxCapabilities

ドライバーによって割り当てられた NET_ADAPTER_RX_CAPABILITIES 構造体へのポインター。

[_In_] EvtAdapterReturnRxBuffer

クライアント ドライバーの EVT_NET_ADAPTER_RETURN_RX_BUFFER コールバック関数へのポインター。 詳細については、「解説」を参照してください。

[_In_] MaximumFrameSize

アダプターが受信できる最大フレーム サイズ (バイト単位)。

[_In_] MaximumNumberOfQueues

アダプターがサポートする受信キューの最大数。

戻り値

なし

解説

この関数は、NET_ADAPTER_RX_CAPABILITIES構造体を初期化するために呼び出す 3 つの関数のうちの 1 つです。 どのクライアント ドライバーを呼び出す必要がありますかは、受信バッファーを割り当てる方法と、DMA を使用するかどうかによって異なります。

クライアント ドライバーは 、 手動受信バッファーの割り当てと添付ファイルを実行する場合 は、NET_ADAPTER_RX_CAPABILITIES 構造体を初期化するNET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGEDを呼び出す必要があります。 この関数を呼び出すと、Rx 機能構造体の AllocationMode メンバーが NetRxFragmentBufferAllocationModeDriver に設定され、 AttachmentMode メンバーが NetRxFragmentBufferAttachmentModeDriver に設定されます。 この場合は、システムが受信バッファーで終了した後にオペレーティング システムが呼び出す構造体内の EVT_NET_ADAPTER_RETURN_RX_BUFFER コールバック関数へのポインターも提供する必要があります。

要件

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

こちらもご覧ください

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA