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)
Wdf01000.sys(请参阅框架库版本控制。
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DriverCreate(kmdf)KmdfIrql(kmdf)KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf)

另请参阅

WdfCommonBufferCreate

WdfCommonBufferGetAlignedLogicalAddress

WdfDeviceSetAlignmentRequirement