MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE回呼函式 （ndis.h）

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

Note 您必須使用 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所配置的迷你埠驅動程式共用記憶體基底虛擬位址。 如果配置嘗試失敗，VirtualAddressNULL。

[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 和更新版本支援。
目標平臺	窗戶
標頭	ndis.h （包括 Ndis.h）
IRQL	PASSIVE_LEVEL

另請參閱

MiniportInitializeEx

NdisMAllocateSharedMemoryAsyncEx NdisMRegisterScatterGatherDma