IModelObject::GetLocation メソッド (dbgmodel.h)

GetLocation メソッドは、ネイティブ オブジェクトの場所を返します。 このような場所は通常、デバッグ ターゲットのアドレス空間内の仮想アドレスですが、必ずしもそうであるとは限りません。 このメソッドによって返される場所は、仮想アドレス、レジスタまたはサブレジスタ内の配置を示す、またはデバッグ ホストによって定義されている他の任意のアドレス空間を示す抽象場所です。 結果の Location オブジェクトの HostDefined フィールドが 0 の場合は、その場所が実際には仮想アドレスであることを示します。 このような仮想アドレスは、結果の場所の Offset フィールドを調べることで取得できます。 HostDefined フィールドの 0 以外の値は、オフセット フィールドがそのアドレス空間内のオフセットである代替アドレス空間を示します。 ここでの 0 以外の HostDefined 値の正確な意味は、デバッグ ホストに対してプライベートです。

このメソッドが呼び出される IModelObject が、デバッグ ターゲットの抽象アドレス空間内の場所を持つネイティブコンストラクトでない場合、このメソッドはE_FAILを返します。

構文

HRESULT GetLocation(
  Location *location
);

パラメーター

location

このポインターによって表されるネイティブ オブジェクトの抽象位置がここに返されます。

戻り値

このメソッドは、成功または失敗を示す HRESULT を返します。

備考

コード サンプル

このサンプルでは、Location 構造体 オブジェクトの場所を定義します。

ComPtr<IModelObject> spObject; /* get a native object */

Location loc;
if (SUCCEEDED(spObject->GetLocation(&loc)))
{
    if (loc.IsVirtualAddress()) /* or loc.HostDefined == 0 */
    {
        // The object is in memory at an address specified by Offset
        ULONG64 address = loc.Offset;
    }
    else
    {
        // The object is in some abstract "address space" (e.g.: it's enregistered).  
        // Arithmetic can still be used on the 'Offset' field in order to access
        // sub-objects within the abstract "address space"
    }
}

必要条件

要件	価値
ヘッダー	dbgmodel.h

関連項目

IModelObject インターフェイス の