MÉTHODE IMMDevice ::GetState (mmdeviceapi.h)
La méthode GetState récupère l’état actuel de l’appareil.
Syntaxe
HRESULT GetState(
[out] DWORD *pdwState
);
Paramètres
[out] pdwState
Pointeur vers une variable DWORD dans laquelle la méthode écrit l’état actuel de l’appareil. La valeur de l’état de l’appareil est l’une des constantes DEVICE_STATE_XXX suivantes :
DEVICE_STATE_ACTIVE
DEVICE_STATE_DISABLED
DEVICE_STATE_NOTPRESENT
DEVICE_STATE_UNPLUGGED
Valeur retournée
Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.
Code de retour | Description |
---|---|
|
Le paramètre pdwState a la valeur NULL. |
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | mmdeviceapi.h |