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
E_POINTER
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

Voir aussi

IMMDevice, interface