通过

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分配的共享内存的基虚拟地址。 如果分配尝试失败，VirtualAddressNULL。

[in] PhysicalAddress

要用于映射到 VirtualAddress 参数指定的地址的 NIC 的基本物理地址。

[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 及更高版本中受支持。
目标平台 窗户
标头 ndis.h （包括 Ndis.h）
IRQL PASSIVE_LEVEL

另请参阅

MiniportInitializeEx

NdisMAllocateSharedMemoryAsyncEx NdisMRegisterScatterGatherDma