MINIPORT_ALLOCATE_SHARED_MEM_COMPLETE回调函数 (ndis.h)
NDIS 调用微型端口驱动程序的 MiniportSharedMemoryAllocateComplete 函数,以完成微型端口驱动程序通过调用 启动的共享内存分配请求 NdisMAllocateSharedMemoryAsyncEx 函数。
语法
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 |