Méthode IWMDMDeviceControl ::GetStatus (mswmdm.h)
La méthode GetStatus récupère les status de contrôle de l’appareil.
Syntaxe
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Paramètres
[out] pdwStatus
Pointeur vers un DWORD qui spécifie le status de contrôle de l’appareil. La valeur status contrôle spécifie un ou plusieurs des indicateurs suivants.
| Indicateur | Description |
|---|---|
| WMDM_STATUS_READY | Windows Media Gestionnaire de périphériques et ses sous-composants sont prêts. |
| WMDM_STATUS_BUSY | Une opération est en cours d’exécution. Évaluez les autres valeurs status pour déterminer de quelle opération il s’agit. |
| WMDM_STATUS_DEVICECONTROL_PLAYING | L’appareil est en cours de lecture. |
| WMDM_STATUS_DEVICECONTROL_RECORDING | L’appareil est en cours d’enregistrement. |
| WMDM_STATUS_DEVICECONTROL_PAUSED | L’appareil est actuellement suspendu. |
| WMDM_STATUS_DEVICECONTROL_REMOTE | L’opération de lecture ou d’enregistrement de l’appareil est contrôlée à distance par l’application. |
| WMDM_STATUS_DEVICECONTROL_STREAM | La méthode de lecture ou d’enregistrement consiste à diffuser en continu des données vers ou à partir de l’appareil multimédia. |
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
S_OK |
|
Le paramètre pdwStatus est un pointeur non valide ou NULL. |
|
Une erreur non spécifiée s'est produite. |
Remarques
Cet appel retourne status valeurs spécifiques aux opérations de contrôle d’appareil de cette interface. Le status de contrôle peut fournir des informations sur l’état des activités liées au contrôle de l’appareil, telles que la lecture, l’enregistrement, etc. Toutefois, il ne peut pas fournir d’informations sur la status globale de l’appareil, par exemple si l’appareil télécharge des données ou est accessible pour une autre raison. Si l’appareil est occupé pour une raison autre que le contrôle de l’appareil, vous recevez un code occupé et vous devez appeler la méthode IWMDMDeviceControl ::GetStatus pour obtenir des informations plus détaillées.
Vous ne devez pas tenter d’appeler les méthodes Play, Record, Pause, Resume ou Stop de cette interface si la valeur status WMDM_STATUS_BUSY est retournée et que la valeur status ne contient pas d’autres valeurs de la table de valeurs status.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |