UMDEtwLogMapAllocation 関数 (umdprovider.h)

  • [アーティクル]

Microsoft DirectX グラフィックス カーネル サブシステム (Dxgkrnl.sys) のメモリ割り当て、または割り当ての一部がどのように使用されているかについて説明します。

構文

void UMDEtwLogMapAllocation(
  ULONGLONG                  hD3DAllocation,
  ULONGLONG                  hDxgAllocation,
  ULONGLONG                  Offset,
  ULONGLONG                  Size,
  UMDETW_ALLOCATION_USAGE    Usage,
  UMDETW_ALLOCATION_SEMANTIC Semantic
);

パラメーター

hD3DAllocation

Direct3D 割り当てのハンドル。

Direct3D 10 ユーザー モード ドライバーの場合、ハンドルは CreateResource(D3D10) 関数の hResource パラメーターの値になります。 Direct3D 9 ユーザー モード ドライバーの場合、ハンドルは、ドライバーが CreateResource 関数で返す pResource パラメーターの値になります。

ドライバーは、割り当てを内部的に使用する場合、この値を NULL に設定できます。

hDxgAllocation

Direct3D 割り当てがマップされる DirectX グラフィックス カーネル サブシステム (Dxgkrnl.sys) 割り当てへのハンドル。

Offset

Dxgkrnl 割り当て内の Direct3D 割り当ての開始アドレス (バイト単位)。

Size

Dxgkrnl 割り当て内の Direct3D 割り当てのサイズ (バイト単位)。

Usage

このマッピングの理由を示す UMDETW_ALLOCATION_USAGE 構造体。

Semantic

割り当てがユーザー モード ドライバーによって内部的に使用される場合、これは割り当てが何に使用されているかを示す UMDETW_ALLOCATION_SEMANTIC 構造体です。

戻り値

なし

解説

ユーザー モード ディスプレイ ドライバーは、割り当てるビデオ メモリを完全に考慮する必要があるため、割り当てが変更されるたびにイベントをログに記録するには、この関数を呼び出す必要があります。

この関数を呼び出すタイミングの例を次に示します。

  • Direct3D 割り当ては、DirectX グラフィックス カーネル サブシステム (Dxgkrnl.sys) 割り当てにパックされます。
  • Dxgkrnl 割り当てがスクラッチ サーフェスとして作成されます。 この場合は、 hD3DAllocation パラメーターを NULL に設定 します。
UMDEtwLogMapAllocation は、Umdprovider.h で次のようにインラインで定義されます。
FORCEINLINE void LogMapAllocation(BOOLEAN Enter,
                    ULONGLONG hD3DAllocation,
                    ULONGLONG hDxgAllocation,
                    ULONGLONG Offset,
                    ULONGLONG Size,
                    UMDETW_ALLOCATION_USAGE Usage,
                    UMDETW_ALLOCATION_SEMANTIC Semantic)
{
    if (Enabled)
    {   
        EVENT_DATA_DESCRIPTOR Descriptors[6];
        
        // Create a description of the event
        EventDataDescCreate(&Descriptors[0], &hD3DAllocation, 8);
        EventDataDescCreate(&Descriptors[1], &hDxgAllocation, 8);
        EventDataDescCreate(&Descriptors[2], &Offset, 8);
        EventDataDescCreate(&Descriptors[3], &Size, 8);
        EventDataDescCreate(&Descriptors[4], &Usage, 4);
        EventDataDescCreate(&Descriptors[5], &Semantic, 4);

        // Log the event
        EventWrite(
            RegHandle,
            Enter ? (InRundown ? &RundownAllocationEvent : &MapAllocationEvent) : &UnmapAllocationEvent,
            sizeof(Descriptors) / sizeof(Descriptors[0]),
            Descriptors
        );
    }
}

FORCEINLINE void UMDEtwLogMapAllocation(ULONGLONG hD3DAllocation,
                            ULONGLONG hDxgAllocation,
                            ULONGLONG Offset,
                            ULONGLONG Size,
                            UMDETW_ALLOCATION_USAGE Usage,
                            UMDETW_ALLOCATION_SEMANTIC Semantic)
{
    LogMapAllocation(TRUE,
                     hD3DAllocation,
                     hDxgAllocation,
                     Offset,
                     Size,
                     Usage,
                     Semantic);
}

要件

要件 値
サポートされている最小のクライアント Windows 8
サポートされている最小のサーバー Windows Server 2012
対象プラットフォーム デスクトップ
Header umdprovider.h (Umdprovider.h を含む)

こちらもご覧ください

CreateResource

CreateResource(D3D10)

UMDETW_ALLOCATION_SEMANTIC

UMDETW_ALLOCATION_USAGE