MINIPORT_RETURN_NET_BUFFER_LISTS回呼函式 (ndis.h)

發行項
02/26/2024

NDIS 會呼叫 MiniportReturnNetBufferLists 函式，以將 NET_BUFFER_LIST 結構的擁有權、相關聯的 NET_BUFFER 結構，以及任何附加的 MDL 傳回至迷你埠驅動程式。

注意您必須使用 MINIPORT_RETURN_NET_BUFFER_LISTS 類型來宣告函式。如需詳細資訊，請參閱下列範例一節。

語法

MINIPORT_RETURN_NET_BUFFER_LISTS MiniportReturnNetBufferLists;

void MiniportReturnNetBufferLists(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNET_BUFFER_LIST NetBufferLists,
  [in] ULONG ReturnFlags
)
{...}

參數

[in] MiniportAdapterContext

迷你埠驅動程式在其 MiniportInitializeEx 函式中配置的內容區域句柄。迷你埠驅動程式會使用此內容區域來維護適配卡的狀態資訊。

[in] NetBufferLists

NDIS 傳回至迷你埠驅動程式之 NET_BUFFER_LIST 結構連結清單的指標。連結清單可以包含多個先前對的呼叫NET_BUFFER_LIST結構 NdisMIndicateReceiveNetBufferLists 函式。

[in] ReturnFlags

可與 OR 作業結合的 NDIS 旗標。此函式支援NDIS_RETURN_FLAGS_DISPATCH_LEVEL旗標，如果設定，表示目前的 IRQL DISPATCH_LEVEL。如需此旗標的詳細資訊，請參閱分派 IRQL 追蹤。

傳回值

無

備註

MiniportReturnNetBufferLists 是迷你埠驅動程式的必要函式，指出已接收的網路數據與 NdisMIndicateReceiveNetBufferLists 函式。當過度處理驅動程式呼叫時 NdisReturnNetBufferLists 函式 NDIS 會呼叫 MiniportReturnNetBufferLists 迷你埠驅動程式的函式，指出指定的 NET_BUFFER_LIST 結構。

MiniportReturnNetBufferLists 可以準備傳回的NET_BUFFER_LIST結構，以供後續接收指示使用。雖然 MiniportReturnNetBufferLists 可以將NET_BUFFER_LIST結構傳回集區 (，但是它可以呼叫 NdisFreeNetBufferList 函式) ，但可以更有效率地重複使用結構，而不將它們傳回集區。

NDIS 會在 IRQL<= DISPATCH_LEVEL呼叫 MiniportReturnNetBufferLists。

例子

若要定義 MiniportReturnNetBufferLists 函式，您必須先提供函式宣告來識別您要定義的函式類型。 Windows 提供一組驅動程式的函式類型。使用函式類型宣告函式有助於驅動程式的程式代碼分析、靜態驅動程序驗證器 (SDV) ，以及其他驗證工具會尋找錯誤，而且這是撰寫 Windows 操作系統驅動程式的需求。

例如，若要定義名為「MyReturnNetBufferLists」的 MiniportReturnNetBufferLists 函式，請使用 MINIPORT_RETURN_NET_BUFFER_LISTS 類型，如下列程式代碼範例所示：

MINIPORT_RETURN_NET_BUFFER_LISTS MyReturnNetBufferLists;

然後，實作您的函式，如下所示：

_Use_decl_annotations_
VOID
 MyReturnNetBufferLists(
    NDIS_HANDLE  MiniportAdapterContext,
    PNET_BUFFER_LIST  NetBufferLists,
    ULONG  ReturnFlags
    )
  {...}

MINIPORT_RETURN_NET_BUFFER_LISTS函式類型定義於 Ndis.h 頭檔中。若要在執行程式代碼分析工具時更精確地識別錯誤，請務必將 Use_decl_annotations 註釋新增至函式定義。 Use_decl_annotations註釋可確保使用頭檔中套用至MINIPORT_RETURN_NET_BUFFER_LISTS函式類型的批註。如需函式宣告需求的詳細資訊，請參閱使用 NDIS 驅動程式的函式角色類型來宣告函式。

如需 Use_decl_annotations的詳細資訊，請參閱標註函式行為。