NdisMAllocateSharedMemory 函式 (ndis.h)
警告
針對 ARM 和 ARM64 處理器，我們強烈建議 NDIS 驅動程式寫入器使用 WDF DMA 或 WDM DMA，而不是 NDIS 散佈圖/收集 DMA。
如需 WDF DMA 的詳細資訊，請參閱 處理 KMDF 驅動程式中的 DMA 作業。
如需 WDM DMA 的詳細資訊，請參閱 管理驅動程式輸入/輸出的 DMA 相關子主題。
NdisMAllocateSharedMemory 會配置和對應主機記憶體範圍，讓記憶體範圍可從主機系統和 DMA NIC 同時存取。
語法
void NdisMAllocateSharedMemory(
[in] NDIS_HANDLE MiniportAdapterHandle,
[in] ULONG Length,
[in] BOOLEAN Cached,
[out] PVOID *VirtualAddress,
[out] PNDIS_PHYSICAL_ADDRESS PhysicalAddress
);
參數
[in] MiniportAdapterHandle
指定 MiniportInitializeEx 的句柄輸入。
[in] Length
指定要配置的位元組數。
[in] Cached
(快取記憶體一律用於 x86 和 x64 系統上) ，則會忽略此參數。
[out] VirtualAddress
呼叫端提供的變數指標，此函式會傳回配置基底虛擬位址以供迷你埠驅動程式使用。 如果 NdisMAllocateSharedMemory 無法滿足其呼叫端，則會傳回 NULL ，表示未配置任何記憶體。
[out] PhysicalAddress
呼叫端提供的變數指標，此變數會傳回實體位址，適合供 NIC 使用，對應至 VirtualAddress 傳回的變數，或傳回 NULL。
傳回值
無
備註
NdisMAllocateSharedMemory 提供驅動程式用來存取共用記憶體區塊的對應虛擬位址範圍，以及 NIC 使用的 NDIS_PHYSICAL_ADDRESS類型範圍。 在 PhysicalAddress 傳回的值可由系統進行兩次對應。 也就是說， 在 PhysicalAddress 和 Length 值所描述的「實體」位址範圍可以是一系列對應邏輯位址，不符合每個可能平臺中配置之主機實體位址的範圍。
NdisMAllocateSharedMemory 只能從 MiniportInitializeEx 呼叫。 要要求的配置大小取決於驅動程式寫入器如何瞭解 NIC 的功能和功能，決定在下列效能與大小挑戰之間進行取捨：
-
在高網路流量期間，如果迷你埠驅動程式對可存取裝置數據緩衝區的共用記憶體空間執行不足，則無法維持高 I/O 輸送量。
例如，迷你埠驅動程式可能表示在共用記憶體中接收緩衝區的速度比這類緩衝區在接收接收傳入NIC時，會從系結通訊協定驅動程式傳回。 如果未處理的接收緩衝區會取用其所有共用記憶體空間，迷你埠驅動程式可能必須停用 NIC 上的接收中斷，直到它有一些可供接收緩衝區使用的共用記憶體空間為止。
- 另一方面，呼叫 NdisMAllocateSharedMemory ，並選擇使用 長度 來預測一些最大傳輸需求，讓驅動程式的映像較大，而且其資源使用量相當不一定，但非常罕見的 I/O 需求期間除外。 此外，如果系統記憶體不足， NdisMAllocateSharedMemory 可能無法為驅動程式提供這樣的大型區塊，而強制驅動程式無法初始化。
NdisMAllocateSharedMemory 和 NdisMAllocateSharedMemoryAsyncEx 是唯一可以呼叫的 NdisXxx 函式，可用來配置驅動程式之間共用的主機記憶體，該驅動程式會使用虛擬位址，以及使用對應邏輯位址的 NIC。
迷你埠驅動程式應該將它從共用快取記憶體配置的緩衝區對齊主機數據快取行界限的整數，以防止在 DMA 期間快取行中斷。 快取行卸除可能會導致驅動程式中的數據完整性問題，或藉由要求過多的數據快取排清來維護數據完整性，使驅動程式的 (和系統的) I/O 效能降低。 MiniportInitializeEx 可以呼叫 NdisMGetDmaAlignment ，以判斷目前平臺中裝置可存取緩衝區的對齊界限，驅動程式將在已配置的共用記憶體範圍內設定。
迷你埠驅動程序應該設定可配置多少共用記憶體的限制。 此限制是驅動程式特定的，而且應該夠高，因此驅動程式不會用盡緩衝區。 請勿設定過高的限制，因為這可能會浪費耗用可能會降低系統效能的共用記憶體。
MiniportInitializeEx 也可能在呼叫 NdisMAllocateSharedMemory 之前呼叫 NdisMAllocateSharedMemory，如果驅動程式寫入器決定在多處理器機器中配置較大的共用記憶體區塊，假設任何 SMP 機器都可能是 NIC 上網路傳輸需求高於工作站的網路伺服器。
如果 對 NdisMAllocateSharedMemory 的呼叫失敗， MiniportInitializeEx 可以再次呼叫要求較小的配置。 不過，如果 MiniportInitializeEx 無法為 NIC 配置足夠的共用記憶體，則必須釋放已配置的所有資源，並失敗初始化。
如果迷你埠驅動程序後續指出接收 NdisMIndicateReceiveNetBufferLists，它必須從緩衝池配置一些緩衝區描述元，以對應 NIC 在共用記憶體區塊中的接收緩衝區。
如果已配置的記憶體已快取，因此必須在傳輸時排清，迷你埠驅動程序必須呼叫 NdisAllocateMdl ，為共用記憶體範圍配置NDIS_BUFFER類型描述元。 迷你埠驅動程序必須使用此緩衝區描述元呼叫 KeFlushIoBuffers ，才能執行這類排清。
如果迷你埠驅動程式呼叫 NdisMAllocateSharedMemoryAsyncEx 或 NdisMAllocateSharedMemory，它必須釋放所有未完成的配置，並在移除 NIC 時釋放 對 NdisMFreeSharedMemory 的呼叫，也就是呼叫 其 MiniportHaltEx 函式時。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
| 目標平台 | Universal |
| 標頭 | ndis.h (包括 Ndis.h) |
| 程式庫 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |