通过

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