ID3DUserDefinedAnnotation::BeginEvent-Methode (d3d11_1.h)

Markiert den Anfang eines Abschnitts des Ereigniscodes.

Syntax

INT BeginEvent(
  [in] LPCWSTR Name
);

Parameter

[in] Name

Eine MIT NULL beendete UNICODE-Zeichenfolge , die den Namen des Ereignisses enthält. Der Name ist für das Betriebssystem nicht relevant. Sie können einen Aussagekräftigen Namen auswählen, wenn die aufrufende Anwendung unter dem Direct3D-Profilerstellungstool ausgeführt wird. Ein NULL-Zeiger erzeugt nicht definierte Ergebnisse.

Rückgabewert

Gibt die Anzahl der vorherigen Aufrufe von BeginEvent zurück, die noch nicht durch Aufrufe der ID3DUserDefinedAnnotation::EndEvent-Methode abgeschlossen wurden.

Der Rückgabewert ist –1, wenn die aufrufende Anwendung nicht unter einem Direct3D-Profilerstellungstool ausgeführt wird.

Hinweise

Sie rufen die EndEvent-Methode auf, um das Ende des Abschnitts des Ereigniscodes zu markieren.

Ein Benutzer kann das Ereignis visualisieren, wenn die aufrufende Anwendung unter einem aktivierten Direct3D-Profilerstellungstool wie Microsoft Visual Studio Ultimate 2012 ausgeführt wird.

BeginEvent hat keine Auswirkung, wenn die aufrufende Anwendung nicht unter einem aktivierten Direct3D-Profilerstellungstool ausgeführt wird.

Beispiele

Der folgende Code zeigt, wie Sie ein Paar von Aufrufen für die Methoden BeginEvent und EndEvent verwenden. Außerdem wird der intelligente Zeigertyp CComPtr verwendet.

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( );
          

Anforderungen

Weitere Informationen

ID3DUserDefinedAnnotation