Index de l’appareil demandé. Pour les appels initiaux, cette valeur doit être égale à zéro.
[in] QueryInterpretationFlags
Critères appliqués aux résultats de la recherche.
Valeur
Signification
DEVICEPOWER_HARDWAREID
0x80000000
Retourne une chaîne d’ID matériel plutôt qu’un nom d’appareil convivial.
DEVICEPOWER_FILTER_DEVICES_PRESENT
0x20000000
Ignorez les appareils qui ne sont pas présents dans le système.
DEVICEPOWER_AND_OPERATION
0x40000000
Effectuez une opération AND sur QueryFlags.
DEVICEPOWER_FILTER_WAKEENABLED
0x08000000
Vérifiez si l’appareil est actuellement activé pour sortir le système d’un état de veille.
DEVICEPOWER_FILTER_ON_NAME
0x02000000
Recherchez un appareil dont le nom correspond à la chaîne transmise dans pReturnBuffer et case activée ses fonctionnalités par rapport à QueryFlags.
[in] QueryFlags
Critères de requête.
Valeur
Signification
PDCAP_D0_SUPPORTED
0x00000001
L’appareil prend en charge l’état d’alimentation du système D0.
PDCAP_D1_SUPPORTED
0x00000002
L’appareil prend en charge l’état d’alimentation du système D1.
PDCAP_D2_SUPPORTED
0x00000004
L’appareil prend en charge l’état d’alimentation du système D2.
PDCAP_D3_SUPPORTED
0x00000008
L’appareil prend en charge l’état d’alimentation du système D3.
PDCAP_S0_SUPPORTED
0x00010000
L’appareil prend en charge l’état de veille du système S0.
PDCAP_S1_SUPPORTED
0x00020000
L’appareil prend en charge l’état de veille du système S1.
PDCAP_S2_SUPPORTED
0x00040000
L’appareil prend en charge l’état de veille du système S2.
PDCAP_S3_SUPPORTED
0x00080000
L’appareil prend en charge l’état de veille du système S3.
PDCAP_S4_SUPPORTED
0x01000000
L’appareil prend en charge l’état de veille du système S4.
PDCAP_S5_SUPPORTED
0x02000000
L’appareil prend en charge l’état de veille du système S5.
PDCAP_WAKE_FROM_D0_SUPPORTED
0x00000010
L’appareil prend en charge la sortie de l’état d’alimentation du système D0.
PDCAP_WAKE_FROM_D1_SUPPORTED
0x00000020
L’appareil prend en charge la sortie de l’état d’alimentation du système D1.
PDCAP_WAKE_FROM_D2_SUPPORTED
0x00000040
L’appareil prend en charge la sortie de l’état d’alimentation du système D2.
PDCAP_WAKE_FROM_D3_SUPPORTED
0x00000080
L’appareil prend en charge la sortie de l’état d’alimentation du système D3.
PDCAP_WAKE_FROM_S0_SUPPORTED
0x00100000
L’appareil prend en charge la sortie de l’état de veille du système S0.
PDCAP_WAKE_FROM_S1_SUPPORTED
0x00200000
L’appareil prend en charge la sortie de l’état de veille du système S1.
PDCAP_WAKE_FROM_S2_SUPPORTED
0x00400000
L’appareil prend en charge la sortie de l’état de veille du système S2.
PDCAP_WAKE_FROM_S3_SUPPORTED
0x00800000
L’appareil prend en charge la sortie de l’état de veille du système S3.
PDCAP_WARM_EJECT_SUPPORTED
0x00000100
L’appareil prend en charge l’éjection à chaud.
[out, optional] pReturnBuffer
Pointeur vers une mémoire tampon qui reçoit les informations demandées.
[in, out] pBufferSize
Taille, en octets, de la mémoire tampon de retour.
Note Si pReturnBuffer a la valeur NULL, pBufferSize est rempli avec la taille nécessaire pour retourner les données.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro.
Notes
Les valeurs du paramètre QueryFlags peuvent être combinées pour rechercher des appareils qui prennent en charge au moins deux critères. Par exemple ; si PDCAP_D3_SUPPORTED |
PDCAP_D1_SUPPORTED est passé en tant que paramètre QueryFlags , la fonction interroge les appareils qui prennent en charge D3 ou D1.
QueryFlags peut également être combiné avec QueryInterpretationFlags défini sur DEVICEPOWER_AND_OPERATION pour produire une requête d’appareils qui prennent en charge tous les critères demandés. Par exemple ; si PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTED est passé en tant que paramètre QueryFlags et DEVICEPOWER_AND_OPERATION en tant que paramètre QueryInterpretationFlags , la fonction interroge les appareils qui prennent en charge D3 et D1.