NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED関数 (netadapter.h)

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED関数は、オペレーティング システムで管理される受信バッファーの割り当てと添付ファイルを指定するが、DMA メモリ マッピングの使用を指定しないネット アダプターのNET_ADAPTER_RX_CAPABILITIES構造を初期化します。

構文

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
  [_In_]  SIZE_T                      MaximumFrameSize,
  [_In_]  SIZE_T                      MaximumNumberOfQueues
);

パラメーター

[_Out_] RxCapabilities

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

[_In_] MaximumFrameSize

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

[_In_] MaximumNumberOfQueues

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

戻り値

なし

解説

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

クライアント ドライバーは オペレーティング システムで受信バッファーの割り当てと添付ファイルを実行する必要があるが、DMA メモリ マッピングを必要としない場合は、 NET_ADAPTER_RX_CAPABILITIES 構造体を初期化するNET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGEDを呼び出す必要があります。 この関数を呼び出すと、Rx 機能構造体の AllocationMode メンバーが NetRxFragmentBufferAllocationModeSystem に設定され、 AttachmentMode メンバーが NetRxFragmentBufferAttachmentModeSystem に設定されます。 この場合、ドライバーは DMA 機能を指定しないため、この関数は MappingRequirement メンバーも NetMemoryMappingRequirementNone に設定します。

要件

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

こちらもご覧ください

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA