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 結構。 用戶端驅動程序應該呼叫哪一個,取決於其配置接收緩衝區的方式,以及是否要使用 DMA。
如果想要執行手動接收緩衝區配置和附件,用戶端驅動程序必須呼叫 NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED 來初始化其 NET_ADAPTER_RX_CAPABILITIES 結構。 藉由呼叫此函式,Rx 功能結構的 AllocationMode 成員會設定為 NetRxFragmentBufferAllocationModeDriver,而 AttachmentMode 成員會設定為 NetRxFragmentBufferAttachmentModeDriver。 在此情況下,它也必須提供其 EVT_NET_ADAPTER_RETURN_RX_BUFFER 回呼函式的指標,供作系統在系統完成接收緩衝區之後叫用。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.25 |
最低 UMDF 版本 | 2.33 |
標頭 | netadapter.h (包括 netadaptercx.h) |
IRQL | PASSIVE_LEVEL |