ALLOCATE_SHARED_MEMORY_HANDLER回呼函式 (ndis.h)

  • 發行項

當驅動程式從共用記憶體提供者配置共用記憶體時，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 可以傳回下列狀態值：

傳回碼 Description
NDIS_STATUS_SUCCESS
 作業已成功完成。
NDIS_STATUS_RESOURCES
 作業失敗，因為資源不足而無法完成作業。
NDIS_STATUS_INVALID_PARAMETER
 作業失敗，因為輸入參數無效。
NDIS_STATUS_FAILURE
 作業因未指定的原因而失敗。

備註

當驅動程式呼叫 時，NDIS 會呼叫共用記憶體提供者的 NetAllocateSharedMemory 函 式 NdisAllocateSharedMemory 函式 。

共用記憶體提供者在 中指定 NetAllocateSharedMemory 的進入點 (ALLOCATE_SHARED_MEMORY_HANDLER) NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS 結構。

規格需求

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

另請參閱

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory