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

Marca o início de uma seção do código de evento.

Sintaxe

INT BeginEvent(
  [in] LPCWSTR Name
);

Parâmetros

[in] Name

Uma cadeia de caracteres UNICODE terminada em NULL que contém o nome do evento. O nome não é relevante para o sistema operacional. Você pode escolher um nome significativo quando o aplicativo de chamada estiver em execução na ferramenta de criação de perfil Direct3D. Um ponteiro NULL produz resultados indefinidos.

Retornar valor

Retorna o número de chamadas anteriores para BeginEvent que ainda não foram finalizadas por chamadas para o método ID3DUserDefinedAnnotation::EndEvent .

O valor retornado será –1 se o aplicativo de chamada não estiver em execução em uma ferramenta de criação de perfil Direct3D.

Comentários

Você chama o método EndEvent para marcar o final da seção do código do evento.

Um usuário pode visualizar o evento quando o aplicativo de chamada estiver em execução em uma ferramenta de criação de perfil do Direct3D habilitada, como Microsoft Visual Studio Ultimate 2012.

BeginEvent não terá efeito se o aplicativo de chamada não estiver em execução em uma ferramenta de criação de perfil direct3D habilitada.

Exemplos

O código a seguir mostra como usar um par de chamadas para os métodos BeginEvent e EndEvent . Ele também usa o tipo de ponteiro 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 Valor
Cliente mínimo com suporte Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d3d11_1.h
Biblioteca D3D11.lib

Confira também

ID3DUserDefinedAnnotation