當驅動程式從共用記憶體提供者配置共用記憶體時,NDIS 會呼叫 NetAllocateSharedMemory 函式(ALLOCATE_SHARED_MEMORY_HANDLER進入點)。
語法
ALLOCATE_SHARED_MEMORY_HANDLER AllocateSharedMemoryHandler;
NDIS_STATUS AllocateSharedMemoryHandler(
[in] NDIS_HANDLE ProviderContext,
[in] PNDIS_SHARED_MEMORY_PARAMETERS SharedMemoryParameters,
[in, out] PNDIS_HANDLE pSharedMemoryProviderContext
)
{...}
參數
[in] ProviderContext
識別提供者之驅動程式配置內容資訊的區塊NDIS_HANDLE。 提供者在 ProviderContext 成員中提供這項資訊 NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS 結構。
[in] SharedMemoryParameters
的指標 NDIS_SHARED_MEMORY_PARAMETERS 結構,定義共用記憶體的要求屬性。
[in, out] pSharedMemoryProviderContext
共用記憶體內容區域的句柄指標。 共用記憶體提供者提供句柄,可識別其配置的共享記憶體。
傳回值
NetAllocateSharedMemory 可以傳回下列狀態值:
| 傳回碼 | 描述 |
|---|---|
|
作業已順利完成。 |
|
作業失敗,因為沒有足夠的資源無法完成作業。 |
|
作業失敗,因為輸入參數無效。 |
|
作業因未指定的原因而失敗。 |
言論
當驅動程式呼叫 時,NDIS 會呼叫共用記憶體提供者的 NetAllocateSharedMemory 函式 NdisAllocateSharedMemory 函式。
共用記憶體提供者在 中指定 NetAllocateSharedMemory 的進入點 (ALLOCATE_SHARED_MEMORY_HANDLER) NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS 結構。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.20 和更新版本支援。 |
| 目標平臺 | 桌面 |
| 標頭 | ndis.h (包括 Ndis.h) |
| IRQL | PASSIVE_LEVEL |