Metodo ID3DUserDefinedAnnotation::BeginEvent (d3d11_1.h)

Articolo
02/26/2024

Contrassegna l'inizio di una sezione del codice evento.

Sintassi

INT BeginEvent(
  [in] LPCWSTR Name
);

Parametri

[in] Name

Stringa UNICODE con terminazione NULL contenente il nome dell'evento. Il nome non è rilevante per il sistema operativo. È possibile scegliere un nome significativo quando l'applicazione chiamante è in esecuzione nello strumento di profilatura Direct3D. Un puntatore NULL produce risultati non definiti.

Valore restituito

Restituisce il numero di chiamate precedenti a BeginEvent non ancora completate dalle chiamate al metodo ID3DUserDefinedAnnotation::EndEvent .

Il valore restituito è -1 se l'applicazione chiamante non è in esecuzione con uno strumento di profilatura Direct3D.

Commenti

Chiamare il metodo EndEvent per contrassegnare la fine della sezione del codice evento.

Un utente può visualizzare l'evento quando l'applicazione chiamante è in esecuzione con uno strumento di profilatura Direct3D abilitato, ad esempio Microsoft Visual Studio Ultimate 2012.

BeginEvent non ha alcun effetto se l'applicazione chiamante non è in esecuzione con uno strumento di profilatura Direct3D abilitato.

Esempio

Il codice seguente illustra come usare una coppia di chiamate ai metodi BeginEvent e EndEvent . Usa anche il tipo di puntatore intelligente 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( );

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e aggiornamento della piattaforma per Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 e aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	d3d11_1.h
Libreria	D3D11.lib

Vedi anche

ID3DUserDefinedAnnotation

Condividi tramite