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 を含む) |