Fonction EngQueryDeviceAttribute (winddi.h)
La fonction EngQueryDeviceAttribute permet au pilote d’interroger le système sur des attributs particuliers de l’appareil.
Syntaxe
ENGAPI BOOL EngQueryDeviceAttribute(
[in] HDEV hdev,
[in] ENG_DEVICE_ATTRIBUTE devAttr,
[in] VOID *pvIn,
[in] ULONG ulInSize,
[out] VOID *pvOut,
[out] ULONG ulOutSize
);
Paramètres
[in] hdev
Gérer sur l’appareil. Ce paramètre est le handle GDI reçu par la fonction DrvCompletePDEV du pilote.
[in] devAttr
Spécifie l’attribut pour lequel GDI doit retourner des informations. Ce paramètre doit être QDA_ACCELERATION_LEVEL, ce qui interroge les accélérations de pilote actuellement permises par GDI.
[in] pvIn
Réservé pour le système. Ce paramètre est actuellement ignoré par GDI.
[in] ulInSize
Réservé pour le système. Ce paramètre est actuellement ignoré par GDI.
[out] pvOut
Pointeur vers une mémoire tampon d’octets ulOutSize dans laquelle GDI écrit des informations sur l’attribut interrogé. Lorsque devAttr est QDA_ACCELERATION_LEVEL, GDI écrit dans la mémoire tampon une valeur DWORD comprise entre 0 et 5 qui indique le niveau d’accélération actuel. Pour obtenir une description des niveaux d’accélération, consultez Afficher les outils de test des pilotes.
[out] ulOutSize
Spécifie la taille, en octets, de la mémoire tampon vers laquelle pvOut pointe.
Valeur retournée
EngQueryDeviceAttribute retourne TRUE en cas de réussite ; sinon, elle retourne FALSE.
Remarques
Le niveau d’accélération de l’carte vidéo peut être défini dynamiquement via le programme d’affichage dans Panneau de configuration. EngQueryDeviceAttribute permet au pilote de déterminer le niveau d’accélération actuellement défini.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |