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 回呼函式的指標，才能在系統完成接收緩衝區之後叫用。

規格需求

另請參閱

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA