ID3D10Device::CheckCounter, méthode (d3d10.h)

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

Syntaxe

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

Paramètres

[in] pDesc

Type : const D3D10_COUNTER_DESC*

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

[out] pType

Type : D3D10_COUNTER_TYPE*

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

[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] szName

Type : LPSTR

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

[in, out] pNameLength

Type : UINT*

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

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

Type : UINT*

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

[out] 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] 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 10 suivants.

Remarques

Les paramètres de longueur peuvent être NULL, ce qui indique que l’application ne s’intéresse pas à la longueur ni à la valeur de chaîne correspondante. Lorsqu’un paramètre de longueur n’a pas la valeur NULL et que la chaîne correspondante a la valeur 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 la longueur 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 d’espace, puis la longueur de la chaîne (y compris le caractère NULL de fin) est transmise via le paramètre length.

Configuration requise

Voir aussi

ID3D10Device Interface