PFND3D10DDI_CHECKCOUNTER fonction de rappel (d3d10umddi.h)

  • Article

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)

Voir aussi

D3D10DDI_DEVICEFUNCS

D3D10DDI_QUERY

pfnSetErrorCb