MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE回调函数 (ndis.h)

  • 项目

NDIS 调用微型端口驱动程序的 MiniportSharedMemoryAllocateComplete 函数，以完成微型端口驱动程序通过调用 启动的共享内存分配请求 NdisMAllocateSharedMemoryAsyncEx 函数。

注意 必须使用 MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE 类型声明函数。 有关详细信息，请参阅以下示例部分。
 

语法

MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE MiniportAllocateSharedMemComplete;

void MiniportAllocateSharedMemComplete(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PVOID VirtualAddress,
  [in] PNDIS_PHYSICAL_ADDRESS PhysicalAddress,
  [in] ULONG Length,
  [in] PVOID Context
)
{...}

参数

[in] MiniportAdapterContext

微型端口驱动程序分配的上下文区域的句柄，驱动程序在其中维护 NIC 的状态信息。 驱动程序在 中分配此上下文区域 MiniportInitializeEx 函数。

[in] VirtualAddress

微型端口驱动程序通过调用 NdisMAllocateSharedMemoryAsyncEx 分配的共享内存的基虚拟地址。 如果分配尝试失败，VirtualAddress 为 NULL。

[in] PhysicalAddress

NIC 要使用的基物理地址，该地址映射到 VirtualAddress 参数指定的地址。

[in] Length

NdisMAllocateSharedMemoryAsyncEx 分配的字节数。

[in] Context

指向微型端口驱动程序在前面调用 NdisMAllocateSharedMemoryAsyncEx 中指定的上下文区域的指针。

返回值

无

备注

MiniportAllocateSharedMemoryComplete 是微型端口驱动程序的可选函数。 微型端口驱动程序在驱动程序传递给 的 NDIS_SG_DMA_DESCRIPTION 结构中注册 MiniportAllocateSharedMemoryComplete 函数 NdisMRegisterScatterGatherDma 函数。

微型端口驱动程序调用用于分配共享内存的 NdisMAllocateSharedMemoryAsyncEx。 如果 NdisMAllocateSharedMemoryAsyncEx 返回NDIS_STATUS_PENDING，则 NDIS 调用 MiniportAllocateSharedMemoryComplete 将内存传递给微型端口驱动程序。

NDIS 在 IRQL PASSIVE_LEVEL调用 MiniportSharedMemoryAllocateComplete 。

示例

若要定义 MiniportSharedMemoryAllocateComplete 函数，必须先提供一个函数声明来标识要定义的函数类型。 Windows 为驱动程序提供了一组函数类型。 使用函数类型声明函数可帮助 驱动程序的代码分析、 静态驱动程序验证程序 (SDV) 和其他验证工具查找错误，并且这是为 Windows 操作系统编写驱动程序的要求。

例如，若要定义名为“ MySharedMemoryAllocateComplete”的 MiniportSharedMemoryAllocateComplete 函数，请使用 MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE 类型，如以下代码示例所示：

MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE MySharedMemoryAllocateComplete;

然后，按如下所示实现函数：

_Use_decl_annotations_
VOID
 MySharedMemoryAllocateComplete(
    NDIS_HANDLE  MiniportAdapterContext,
    PVOID  VirtualAddress,
    PNDIS_PHYSICAL_ADDRESS  PhysicalAddress,
    ULONG  Length,
    PVOID  Context
    )
  {...}

MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE函数类型在 Ndis.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations批注可确保使用应用于头文件中MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE函数类型的注释。 有关函数声明要求的详细信息，请参阅 使用 NDIS 驱动程序的函数角色类型声明函数。

有关 Use_decl_annotations的信息，请参阅 批注函数行为。

要求

要求 值
最低受支持的客户端 在 NDIS 6.0 及更高版本中受支持。
目标平台 Windows
标头 ndis.h (包括 Ndis.h)
IRQL PASSIVE_LEVEL

另请参阅

MiniportInitializeEx

NdisMAllocateSharedMemoryAsyncEx NdisMRegisterScatterGatherDma