共用方式為

ID3DUserDefinedAnnotation：：BeginEvent 方法 (d3d11_1.h)

  • 發行項

標記事件程式代碼區段的開頭。

語法

INT BeginEvent(
  [in] LPCWSTR Name
);

參數

[in] Name

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

傳回值

傳回呼叫ID3DUserDefinedAnnotation：：EndEvent方法尚未完成的BeginEvent先前呼叫數目。

如果呼叫的應用程式未在 Direct3D 分析工具下執行，則傳回值為 –1。

備註

您可以呼叫 EndEvent 方法來標記事件程式代碼區段的結尾。

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

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

範例

下列程式代碼示範如何使用 一對 BeginEvent 和 EndEvent 方法的呼叫。 它也使用 CComPtr 智慧型手機型指標類型。


CComPtr< ID3D11DeviceContext > pContext;

HRESULT hrCreateDevice = (*pfnD3D11CreateDevice)( 
        0,
        D3D_DRIVER_TYPE_NULL,
        0,
        0,
        NULL,
        0,
        D3D11_SDK_VERSION,
        NULL,
        0,
        & pContext );
VERIFY_SUCCEEDED(hrCreateDevice);
CComPtr<ID3DUserDefinedAnnotation> pPerf;
HRESULT hr = pContext->QueryInterface( __uuidof(pPerf), reinterpret_cast<void**>(&pPerf) );
if ( FAILED( hr ) ) 
    return;
pPerf->BeginEvent( L”Now entering ocean rendering code” );
MyDrawOceanRoutine( );
pPerf->EndEvent( );

規格需求

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

另請參閱

ID3DUserDefinedAnnotation