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 可以傳回下列狀態值:

傳回碼 描述
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