ID3DUserDefinedAnnotation ::SetMarker, méthode (d3d11_1.h)

Marque un point d’exécution unique dans le code.

Syntaxe

void SetMarker(
  [in] LPCWSTR Name
);

Paramètres

[in] Name

Chaîne UNICODE terminée par NULL qui contient le nom du marqueur. Le nom n’est pas pertinent pour le système d’exploitation. Vous pouvez choisir un nom qui est significatif lorsque l’application appelante s’exécute sous l’outil de profilage Direct3D. Un pointeur NULL produit des résultats non définis.

Valeur de retour

None

Remarques

Un utilisateur peut visualiser le marqueur lorsque l’application appelante s’exécute sous un outil de profilage Direct3D activé tel que Microsoft Visual Studio Ultimate 2012.

SetMarker n’a aucun effet si l’application appelante ne s’exécute pas sous un outil de profilage Direct3D activé.

Exemples

Le code suivant montre comment utiliser SetMarker. Il utilise également le type de pointeur intelligent 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” );

          

Configuration requise

Voir aussi

ID3DUserDefinedAnnotation