共用方式為

ID3DUserDefinedAnnotation：：SetMarker 方法 (d3d11_1.h)

  • 發行項

標記程式代碼中的單一執行點。

語法

void SetMarker(
  [in] LPCWSTR Name
);

參數

[in] Name

NULL 終止的 UNICODE 字串，其中包含標記的名稱。 名稱與操作系統無關。 您可以在呼叫應用程式在 Direct3D 分析工具下執行時，選擇有意義的名稱。 NULL 指標會產生未定義的結果。

傳回值

無

備註

當使用者在啟用的 Direct3D 分析工具下執行呼叫應用程式時，可以將標記可視化，例如 Microsoft Visual Studio Ultimate 2012。

如果呼叫的應用程式未在啟用的 Direct3D 分析工具下執行，SetMarker 就不會有任何作用。

範例

下列程式代碼示範如何使用 SetMarker。 它也使用 CComPtr 智慧型手機型指標類型。


CComPtr< ID3D11DeviceContext > pID3D11DeviceContext;

HRESULT hrCreateDevice = (*pfnD3D11CreateDevice)( 
        0,
        D3D_DRIVER_TYPE_NULL,
        0,
        0,
        NULL,
        0,
        D3D11_SDK_VERSION,
        NULL,
        0,
        & pID3D11DeviceContext );
VERIFY_SUCCEEDED(hrCreateDevice);

CComPtr<ID3DUserDefinedAnnotation> pPerf;
HRESULT hr = pID3D11DeviceContext->QueryInterface( __uuidof(pPerf), reinterpret_cast<void**>(&pPerf) );
if ( FAILED( hr ) ) 
    return;
pPerf->SetMarker( L”Occlusion test failed- not drawing sun flare” );

規格需求

需求 值
最低支援的用戶端 適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d3d11_1.h
程式庫 D3D11.lib

另請參閱

ID3DUserDefinedAnnotation