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 de l’appareil d’affichage (contexte graphique).
unnamedParam2
requête [in]
Valeur D3D10DDI_QUERY-typée 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 vers lequel 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 pour la création de l’identificateur de compteur qui Requête identifie.
[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 de 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 auquel le pilote retourne une chaîne terminée par NULL qui contient le nom des unités que l’identificateur de compteur mesure.
[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
Aucun
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 bien connu que l’appareil ne prend pas en charge.
Le pilote doit valider un identificateur de compteur dépendant de l’appareil pour s’assurer que l’identificateur se trouve dans la plage. Le pilote doit également s’assurer que suffisamment d’espace existe 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 les 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 de vérification des capacités. 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | d3d10umddi.h (include D3d10umddi.h) |