Metodo ID3D11ShaderTrace::TraceReady (d3d11shadertracing.h)

Specifica che la traccia dello shader registrata ed è pronta per l'uso.

Sintassi

HRESULT TraceReady(
  [out, optional] UINT64 *pTestCount
);

Parametri

[out, optional] pTestCount

Puntatore facoltativo a una variabile che riceve il numero di volte in cui si è verificata una chiamata corrispondente per la traccia. Se non viene usato, impostare su NULL. Per altre informazioni su questo numero, vedere Osservazioni.

Valore restituito

TraceReady restituisce :

• S_OK se la traccia è pronta.
• S_FALSE se la traccia non è pronta.
• E_OUTOFMEMORY se la memoria è esaurita durante il processo di registrazione della traccia. È possibile provare a registrare nuovamente la traccia chiamando ID3D11ShaderTrace::ResetTrace e quindi ridisegnando. Se si decide di non registrare nuovamente la traccia, rilasciare l'interfaccia ID3D11ShaderTrace .
• Possibilmente altri codici di errore descritti in Codici restituiti Direct3D 11.

Commenti

Se una traccia è destinata a registrare la chiamata 3 ma sono state eseguite solo due chiamate finora, TraceReady imposta la variabile su cui pTestCount punta a 2. È possibile usare questo valore per comprendere perché una traccia non è ancora pronta. Al contrario, la variabile a cui pTestCount punta potrebbe essere maggiore del numero di chiamate richieste per una traccia pronta. È possibile usare questo valore per determinare il numero di chiamate eseguite oltre il conteggio delle chiamate di traccia necessarie. Ad esempio, è possibile che non si conosca il numero di sovrapposizioni che si verificano su un pixel per un determinato shader in una chiamata di disegno. Se è possibile ridisegnare la scena in modo identico, è possibile configurare le tracce la volta successiva in base al valore restituito da TraceReady in pTestCount al primo passaggio.

Se la traccia dello shader registrata, è possibile chiamare correttamente i metodi ID3D11ShaderTrace::GetTraceStats, ID3D11ShaderTrace::GetInitialRegisterContents e ID3D11ShaderTrace::GetStep . È possibile chiamare i metodi ID3D11ShaderTrace::ResetTrace e ID3D11ShaderTrace::P SSelectStamp indipendentemente dal fatto che la traccia dello shader sia registrata.

Requisiti

Vedi anche

ID3D11ShaderTrace