NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED函式 (netadapter.h)
NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED函式會針對想要指定操作系統管理的接收緩衝區配置和附件的 net 配接器初始化NET_ADAPTER_RX_CAPABILITIES結構,但不會使用 DMA 記憶體對應。
語法
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 結構。 用戶端驅動程序應該呼叫哪一個取決於其配置接收緩衝區的方式,以及是否要使用 DMA。
如果操作系統想要執行接收緩衝區配置和附件,用戶端驅動程序必須呼叫 NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED 來初始化其 NET_ADAPTER_RX_CAPABILITIES 結構,但不需要 DMA 記憶體對應。 藉由呼叫此函式,Rx 功能結構的 AllocationMode 成員會設定為 NetRxFragmentBufferAllocationModeSystem , 而 AttachmentMode 成員會設定為 NetRxFragmentBufferAttachmentModeSystem。 因為驅動程式在此案例中未指定 DMA 功能,所以此函式也會將 MappingRequirement 成員設定為 NetMemoryMappingRequirementNone。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
最低 KMDF 版本 | 1.25 |
最低UMDF版本 | 2.33 |
標頭 | netadapter.h (包含 netadaptercx.h) |