Metodo ID3D11Device::CheckCounter (d3d11.h)

Ottiene il tipo, il nome, le unità di misura e una descrizione di un contatore esistente.

Sintassi

HRESULT CheckCounter(
  [in]                const D3D11_COUNTER_DESC *pDesc,
  [out]               D3D11_COUNTER_TYPE       *pType,
  [out]               UINT                     *pActiveCounters,
  [out, optional]     LPSTR                    szName,
  [in, out, optional] UINT                     *pNameLength,
  [out, optional]     LPSTR                    szUnits,
  [in, out, optional] UINT                     *pUnitsLength,
  [out, optional]     LPSTR                    szDescription,
  [in, out, optional] UINT                     *pDescriptionLength
);

Parametri

[in] pDesc

Tipo: const D3D11_COUNTER_DESC*

Puntatore a una descrizione del contatore (vedere D3D11_COUNTER_DESC). Specifica le informazioni sui contatori da recuperare.

[out] pType

Tipo: D3D11_COUNTER_TYPE*

Puntatore al tipo di dati di un contatore (vedere D3D11_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, optional] 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, optional] pNameLength

Tipo: UINT*

Lunghezza della stringa restituita a szName. Può essere NULL.

[out, optional] 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, optional] pUnitsLength

Tipo: UINT*

Lunghezza della stringa restituita a szUnits. Può essere NULL.

[out, optional] 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, optional] pDescriptionLength

Tipo: UINT*

Lunghezza della stringa restituita a szDescription. Può essere NULL.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce uno dei codici restituiti Direct3D 11 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.

Windows Phone 8: questa API è supportata.

Requisiti

Vedi anche

ID3D11Device