共用方式為

MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE回呼函式 (ndis.h)

  • 發行項

NDIS 會呼叫迷你埠驅動程式的 MiniportSharedMemoryAllocateComplete 函式，以完成由呼叫 來啟動迷你埠驅動程式的共用記憶體配置要求 NdisMAllocateSharedMemoryAsyncEx 函式。

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

語法

MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE MiniportAllocateSharedMemComplete;

void MiniportAllocateSharedMemComplete(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PVOID VirtualAddress,
  [in] PNDIS_PHYSICAL_ADDRESS PhysicalAddress,
  [in] ULONG Length,
  [in] PVOID Context
)
{...}

參數

[in] MiniportAdapterContext

迷你埠驅動程式所配置之內容區域的句柄，驅動程式會維護 NIC 的狀態資訊。 驅動程式會在 中配置此內容區域 MiniportInitializeEx 函式。

[in] VirtualAddress

迷你埠驅動程式所配置的共用記憶體基底虛擬位址，方法是呼叫 NdisMAllocateSharedMemoryAsyncEx。 如果配置嘗試失敗，VirtualAddress 為 NULL。

[in] PhysicalAddress

要用來對應至 VirtualAddress 參數所指定位址之 NIC 的基底實體位址。

[in] Length

NdisMAllocateSharedMemoryAsyncEx 配置的位元元組數目。

[in] Context

上述呼叫 NdisMAllocateSharedMemoryAsyncEx 中所指定迷你埠驅動程式的內容區域指標。

傳回值

無

備註

MiniportAllocateSharedMemoryComplete 是迷你埠驅動程序的選擇性函式。 迷你埠驅動程式會在驅動程序傳遞至 的 NDIS_SG_DMA_DESCRIPTION 結構中註冊 MiniportAllocateSharedMemoryComplete 函式 NdisMRegisterScatterGatherDma 函式。

迷你埠驅動程式呼叫 NdisMAllocateSharedMemoryAsyncEx 以配置共用記憶體。 如果 NdisMAllocateSharedMemoryAsyncEx 傳回NDIS_STATUS_PENDING，NDIS 會呼叫 MiniportAllocateSharedMemoryComplete 將記憶體傳遞至迷你埠驅動程式。

NDIS 會在 IRQL PASSIVE_LEVEL呼叫 MiniportSharedMemoryAllocateComplete 。

例子

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

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

MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE MySharedMemoryAllocateComplete;

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

_Use_decl_annotations_
VOID
 MySharedMemoryAllocateComplete(
    NDIS_HANDLE  MiniportAdapterContext,
    PVOID  VirtualAddress,
    PNDIS_PHYSICAL_ADDRESS  PhysicalAddress,
    ULONG  Length,
    PVOID  Context
    )
  {...}

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

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

規格需求

需求 值
最低支援的用戶端 NDIS 6.0 和更新版本支援。
目標平台 Windows
標頭 ndis.h (包括 Ndis.h)
IRQL PASSIVE_LEVEL

另請參閱

MiniportInitializeEx

NdisMAllocateSharedMemoryAsyncEx NdisMRegisterScatterGatherDma