WdfCommonBufferGetAlignedLogicalAddress 函式 (wdfcommonbuffer.h)

[僅適用於 KMDF]

WdfCommonBufferGetAlignedLogicalAddress 方法會傳回與指定通用緩衝區相關聯的邏輯位址。

語法

PHYSICAL_ADDRESS WdfCommonBufferGetAlignedLogicalAddress(
  [in] WDFCOMMONBUFFER CommonBuffer
);

[in] CommonBuffer

先前呼叫 WdfCommonBufferCreate 所取得之驅動程式所取得之通用緩衝區物件的句柄。

WdfCommonBufferGetAlignedLogicalAddress 會傳回與 CommonBuffer 參數所指定之通用緩衝區相關聯的緩衝區邏輯位址。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

邏輯位址是裝置用來存取物理記憶體的對應位址。

如果名為 WdfDeviceSetAlignmentRequirement 的驅動程式設定緩衝區對齊需求，架構會根據該對齊需求來對齊通用緩衝區。

如需常見緩衝區的詳細資訊，請參閱使用通用緩衝區

如需使用 WdfCommonBufferGetAlignedLogicalAddress 的程式代碼範例，請參閱 WdfCommonBufferCreate。

需求	值
目標平台	Universal
最低 KMDF 版本	1.0
標頭	wdfcommonbuffer.h (包含 WdfCommonBuffer.h)
程式庫	Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)