Método ID3DUserDefinedAnnotation::BeginEvent (d3d11_1.h)

Marca el principio de una sección del código de evento.

Sintaxis

INT BeginEvent(
  [in] LPCWSTR Name
);

Parámetros

[in] Name

Cadena UNICODE terminada en NULL que contiene el nombre del evento. El nombre no es relevante para el sistema operativo. Puedes elegir un nombre que sea significativo cuando la aplicación que realiza la llamada se ejecute en la herramienta de generación de perfiles de Direct3D. Un puntero NULL genera resultados no definidos.

Valor devuelto

Devuelve el número de llamadas anteriores a BeginEvent que aún no se han finalizado mediante llamadas al método ID3DUserDefinedAnnotation::EndEvent .

El valor devuelto es –1 si la aplicación que realiza la llamada no se ejecuta en una herramienta de generación de perfiles de Direct3D.

Comentarios

Llame al método EndEvent para marcar el final de la sección del código de evento.

Un usuario puede visualizar el evento cuando la aplicación que realiza la llamada se ejecuta en una herramienta de generación de perfiles de Direct3D habilitada, como Microsoft Visual Studio Ultimate 2012.

BeginEvent no tiene ningún efecto si la aplicación que realiza la llamada no se ejecuta en una herramienta de generación de perfiles de Direct3D habilitada.

Ejemplos

En el código siguiente se muestra cómo usar un par de llamadas a los métodos BeginEvent y EndEvent . También usa el tipo de puntero inteligente 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( );
          

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d3d11_1.h
Library D3D11.lib

Consulte también

ID3DUserDefinedAnnotation