ID3D11Device::CheckCounter, méthode (d3d11.h)

Obtenez le type, le nom, les unités de mesure et une description d’un compteur existant.

Syntaxe

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
);

Paramètres

[in] pDesc

Type : const D3D11_COUNTER_DESC*

Pointeur vers une description de compteur (voir D3D11_COUNTER_DESC). Spécifie les informations de compteur à récupérer.

[out] pType

Type : D3D11_COUNTER_TYPE*

Pointeur vers le type de données d’un compteur (voir D3D11_COUNTER_TYPE). Spécifie le type de données du compteur en cours de récupération.

[out] pActiveCounters

Type : UINT*

Pointeur vers le nombre de compteurs matériels nécessaires à la création de ce type de compteur. Toutes les instances du même type de compteur utilisent les mêmes compteurs matériels.

[out, optional] szName

Type : LPSTR

Chaîne à remplir avec un nom bref pour le compteur. Peut être NULL si l’application n’est pas intéressée par le nom du compteur.

[in, out, optional] pNameLength

Type : UINT*

Longueur de la chaîne retournée à szName. Peut être NULL.

[out, optional] szUnits

Type : LPSTR

Nom des unités mesurées par un compteur, à condition que la mémoire vers laquelle pointe le pointeur dispose de suffisamment d’espace pour contenir la chaîne. Peut être NULL. La chaîne retournée sera toujours en anglais.

[in, out, optional] pUnitsLength

Type : UINT*

Longueur de la chaîne retournée à szUnits. Peut être NULL.

[out, optional] szDescription

Type : LPSTR

Description du compteur, à condition que la mémoire vers laquelle pointe le pointeur dispose de suffisamment d’espace pour contenir la chaîne. Peut être NULL. La chaîne retournée sera toujours en anglais.

[in, out, optional] pDescriptionLength

Type : UINT*

Longueur de la chaîne retournée à szDescription. Peut être NULL.

Valeur retournée

Type : HRESULT

Cette méthode retourne l’un des codes de retour Direct3D 11 suivants.

Remarques

Les paramètres de longueur peuvent être NULL, ce qui indique que l’application n’est pas intéressée par la longueur ni par la valeur de chaîne correspondante. Lorsqu’un paramètre de longueur n’a pas la valeur NULL et que la chaîne correspondante est NULL, la valeur d’entrée du paramètre length est ignorée et la longueur de la chaîne correspondante (y compris la valeur NULL de fin) est retournée via le paramètre length. Lorsque length et le paramètre correspondant sont tous deux non NULL, la valeur d’entrée de length est vérifiée pour s’assurer qu’il y a suffisamment de place, puis la longueur de la chaîne (y compris le caractère NULL de fin) est passée via le paramètre length.

Windows Phone 8 : Cette API est prise en charge.

Configuration requise

Plateforme cible	Windows
En-tête	d3d11.h
Bibliothèque	D3D11.lib

Voir aussi

ID3D11Device