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 |