Metodo ID3D10Device::CheckCounter (d3d10.h)
Ottiene il tipo, il nome, le unità di misura e una descrizione di un contatore esistente.
Sintassi
HRESULT CheckCounter(
[in] const D3D10_COUNTER_DESC *pDesc,
[out] D3D10_COUNTER_TYPE *pType,
[out] UINT *pActiveCounters,
[out] LPSTR szName,
[in, out] UINT *pNameLength,
[out] LPSTR szUnits,
[in, out] UINT *pUnitsLength,
[out] LPSTR szDescription,
[in, out] UINT *pDescriptionLength
);
Parametri
[in] pDesc
Tipo: const D3D10_COUNTER_DESC*
Puntatore a una descrizione del contatore (vedere D3D10_COUNTER_DESC). Specifica le informazioni sui contatori da recuperare.
[out] pType
Tipo: D3D10_COUNTER_TYPE*
Puntatore al tipo di dati di un contatore (vedere D3D10_COUNTER_TYPE). Specifica il tipo di dati del contatore recuperato.
[out] pActiveCounters
Tipo: UINT*
Puntatore al numero di contatori hardware necessari per creare questo tipo di contatore. Tutte le istanze dello stesso tipo di contatore usano gli stessi contatori hardware.
[out] szName
Tipo: LPSTR
Stringa da compilare con un breve nome per il contatore. Può essere NULL se l'applicazione non è interessata al nome del contatore.
[in, out] pNameLength
Tipo: UINT*
Lunghezza della stringa restituita a szName. Può essere NULL.
[out] szUnits
Tipo: LPSTR
Nome delle unità di misura di un contatore, a condizione che la memoria punti del puntatore abbia spazio sufficiente per contenere la stringa. Può essere NULL. La stringa restituita sarà sempre in inglese.
[in, out] pUnitsLength
Tipo: UINT*
Lunghezza della stringa restituita a szUnits. Può essere NULL.
[out] szDescription
Tipo: LPSTR
Descrizione del contatore, purché la memoria punti del puntatore abbia spazio sufficiente per contenere la stringa. Può essere NULL. La stringa restituita sarà sempre in inglese.
[in, out] pDescriptionLength
Tipo: UINT*
Lunghezza della stringa restituita a szDescription. Può essere NULL.
Valore restituito
Tipo: HRESULT
Questo metodo restituisce uno dei codici restituiti Direct3D 10 seguenti.
Commenti
I parametri di lunghezza possono essere NULL, che indica che l'applicazione non è interessata alla lunghezza né al valore stringa corrispondente. Quando un parametro length è diverso da NULL e la stringa corrispondente è NULL, il valore di input del parametro length viene ignorato e la lunghezza della stringa corrispondente (inclusa la terminazione NULL) verrà restituita tramite il parametro length. Quando length e il parametro corrispondente sono entrambi non NULL, il valore di input di lunghezza viene controllato per assicurarsi che vi sia spazio sufficiente e quindi la lunghezza della stringa (incluso il carattere NULL di terminazione) viene passata attraverso il parametro length.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | d3d10.h |
| Libreria | D3D10.lib |