WdfCommonBufferGetAlignedVirtualAddress 函数 (wdfcommonbuffer.h)

[仅适用于 KMDF]

WdfCommonBufferGetAlignedVirtualAddress 方法返回与指定公共缓冲区关联的虚拟地址。

语法

PVOID WdfCommonBufferGetAlignedVirtualAddress(
  [in] WDFCOMMONBUFFER CommonBuffer
);

参数

[in] CommonBuffer

驱动程序通过上一次调用 WdfCommonBufferCreate 获取的公共缓冲区对象的句柄。

返回值

WdfCommonBufferGetAlignedVirtualAddress 返回与 CommonBuffer 参数指定的公共缓冲区关联的缓冲区的虚拟地址。

如果驱动程序提供无效的对象句柄,则会发生 bug 检查。

注解

如果驱动程序调用 WdfDeviceSetAlignmentRequirement 来设置缓冲区对齐要求,则框架将根据该对齐要求对齐公共缓冲区。

有关常见缓冲区的详细信息,请参阅 使用通用缓冲区

示例

有关使用 WdfCommonBufferGetAlignedVirtualAddress 的代码示例,请参阅 WdfCommonBufferCreate

要求

要求
目标平台 通用
最低 KMDF 版本 1.0
标头 wdfcommonbuffer.h (包括 WdfCommonBuffer.h)
Library Wdf01000.sys (请参阅框架库 Versioning.)
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另请参阅

WdfCommonBufferCreate

WdfCommonBufferGetAlignedLogicalAddress

WdfDeviceSetAlignmentRequirement