WdfCommonBufferGetAlignedLogicalAddress 関数 (wdfcommonbuffer.h)
[KMDF にのみ適用]
WdfCommonBufferGetAlignedLogicalAddress メソッドは、指定された共通バッファーに関連付けられている論理アドレスを返します。
構文
PHYSICAL_ADDRESS WdfCommonBufferGetAlignedLogicalAddress(
[in] WDFCOMMONBUFFER CommonBuffer
);
パラメーター
[in] CommonBuffer
WdfCommonBufferCreate の以前の呼び出しによってドライバーが取得した共通バッファー オブジェクトへのハンドル。
戻り値
WdfCommonBufferGetAlignedLogicalAddress は、 CommonBuffer パラメーターが指定する共通バッファーに関連付けられているバッファーの論理アドレスを返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
論理アドレスは、デバイスが物理メモリへのアクセスに使用するマップされたアドレスです。
ドライバーが WdfDeviceSetAlignmentRequirement を呼び出してバッファーの配置要件を設定した場合、フレームワークは、その配置要件に従って共通バッファーを配置します。
共通バッファーの詳細については、「共通バッファーの使用」を参照してください。
例
WdfCommonBufferGetAlignedLogicalAddress を使用するコード例については、「WdfCommonBufferCreate」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfcommonbuffer.h (WdfCommonBuffer.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |