WdfCommonBufferGetAlignedLogicalAddress 函数 (wdfcommonbuffer.h)

[仅适用于 KMDF]

WdfCommonBufferGetAlignedLogicalAddress 方法返回与指定公共缓冲区关联的逻辑地址。

语法

PHYSICAL_ADDRESS WdfCommonBufferGetAlignedLogicalAddress(
  [in] WDFCOMMONBUFFER CommonBuffer
);

参数

[in] CommonBuffer

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

返回值

WdfCommonBufferGetAlignedLogicalAddress 返回与 CommonBuffer 参数指定的公共缓冲区关联的缓冲区的逻辑地址。

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

注解

逻辑地址是设备用于访问物理内存的映射地址。

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

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

示例

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

要求

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

另请参阅

WdfCommonBufferCreate

WdfCommonBufferGetAlignedVirtualAddress

WdfDeviceSetAlignmentRequirement