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