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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | d3d11_1.h |
| Bibliothek | D3D11.lib |