Metodo ID3DUserDefinedAnnotation::SetMarker (d3d11_1.h)

Articolo
02/28/2024

Contrassegna un singolo punto di esecuzione nel codice.

Sintassi

void SetMarker(
  [in] LPCWSTR Name
);

Parametri

[in] Name

Stringa UNICODE con terminazione NULL contenente il nome del marcatore. Il nome non è pertinente al 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

nessuno

Osservazioni

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

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

Esempio

Il codice seguente illustra come usare SetMarker. Usa anche il tipo di puntatore intelligente CComPtr .


CComPtr< ID3D11DeviceContext > pID3D11DeviceContext;

HRESULT hrCreateDevice = (*pfnD3D11CreateDevice)( 
        0,
        D3D_DRIVER_TYPE_NULL,
        0,
        0,
        NULL,
        0,
        D3D11_SDK_VERSION,
        NULL,
        0,
        & pID3D11DeviceContext );
VERIFY_SUCCEEDED(hrCreateDevice);

CComPtr<ID3DUserDefinedAnnotation> pPerf;
HRESULT hr = pID3D11DeviceContext->QueryInterface( __uuidof(pPerf), reinterpret_cast<void**>(&pPerf) );
if ( FAILED( hr ) ) 
    return;
pPerf->SetMarker( L”Occlusion test failed- not drawing sun flare” );

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