次の方法で共有


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
ヘッダー netadapter.h (netadaptercx.h を含む)

関連項目

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA