PFND3D10DDI_CHECKCOUNTER fonction de rappel (d3d10umddi.h)
La fonction CheckCounter récupère des informations qui décrivent un compteur.
Syntaxe
PFND3D10DDI_CHECKCOUNTER Pfnd3d10ddiCheckcounter;
void Pfnd3d10ddiCheckcounter(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_QUERY unnamedParam2,
D3D10DDI_COUNTER_TYPE *unnamedParam3,
UINT *unnamedParam4,
LPSTR unnamedParam5,
[in, out] UINT *pNameLength,
LPSTR unnamedParam7,
[in, out] UINT *pUnitsLength,
LPSTR unnamedParam9,
[in, out] UINT *pDescriptionLength
)
{...}
Paramètres
unnamedParam1
hDevice [in]
Handle pour le périphérique d’affichage (contexte graphique).
unnamedParam2
Requête [in]
Valeur de type D3D10DDI_QUERY qui identifie l’identificateur de compteur pour lequel les informations sont récupérées.
unnamedParam3
pCounterType [out]
Pointeur vers une variable qui reçoit l’une des valeurs suivantes de l’énumération D3D10DDI_COUNTER_TYPE qui identifie le type de données généré par le compteur.
| Valeur | Signification |
|---|---|
| D3D10DDI_COUNTER_TYPE_FLOAT32 | Float simple précision |
| D3D10DDI_COUNTER_TYPE_UINT16 | Valeur 16 bits |
| D3D10DDI_COUNTER_TYPE_UINT32 | Valeur 32 bits |
| D3D10DDI_COUNTER_TYPE_UINT64 | Valeur 64 bits |
unnamedParam4
pDescription [out]
Pointeur auquel le pilote retourne une chaîne terminée par NULL qui contient la description de ce que l’identificateur de compteur mesure.
unnamedParam5
pActiveCounters [out]
Pointeur vers une variable qui reçoit le nombre de compteurs actifs simultanément alloués à la création de l’identificateur de compteur identifié par la requête .
[in, out] pNameLength
Pointeur vers une variable qui reçoit la taille, en octets, de la chaîne terminée par NULL spécifiée par le paramètre pName .
unnamedParam7
pName [out]
Pointeur vers lequel le pilote retourne une chaîne terminée par NULL qui contient le nom de l’identificateur du compteur.
[in, out] pUnitsLength
Pointeur vers une variable qui reçoit la taille, en octets, de la chaîne terminée par NULL spécifiée par le paramètre pUnits .
unnamedParam9
pUnits [out]
Pointeur vers lequel le pilote retourne une chaîne terminée par NULL qui contient le nom des unités mesurées par l’identificateur de compteur.
[in, out] pDescriptionLength
Pointeur vers une variable qui reçoit la taille, en octets, de la chaîne terminée par NULL spécifiée par le paramètre pDescription .
Valeur de retour
None
Remarques
Le pilote peut utiliser la fonction de rappel pfnSetErrorCb pour définir un code d’erreur.
La fonction CheckCounter du pilote peut appeler la fonction de rappel pfnSetErrorCb pour définir le code d’erreur ERR_UNSUPPORTED si le paramètre Query de CheckCounterspécifie un compteur connu que l’appareil ne prend pas en charge.
Le pilote doit valider un identificateur de compteur dépendant du périphérique pour s’assurer que l’identificateur est dans la plage. Le pilote doit également s’assurer qu’il existe suffisamment d’espace pour copier chaque chaîne de compteur dans chaque mémoire tampon que le runtime Microsoft Direct3D fournit. Le pilote peut appeler la fonction de rappel pfnSetErrorCb pour définir le code d’erreur E_INVALIDARG s’il n’y a pas suffisamment d’espace pour l’une des mémoires tampons fournies.
La fonction CheckCounter du pilote ne peut pas appeler la fonction de rappel pfnSetErrorCb pour définir le code d’erreur D3DDDIERR_DEVICEREMOVED, car CheckCounter est un type de fonction case activée fonctionnalité. Le pilote doit s’assurer qu’il dispose de suffisamment d’informations après la création de l’appareil pour répondre à un appel à CheckCounter, même en présence de D3DDDIERR_DEVICEREMOVED.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | d3d10umddi.h (incluez D3d10umddi.h) |