MÉTHODE IMDSPDeviceControl ::GetDCStatus (mswmdm.h)
La méthode GetDCStatus récupère le contrôle status de l’appareil.
Syntaxe
HRESULT GetDCStatus(
[out] DWORD *pdwStatus
);
Paramètres
[out] pdwStatus
Pointeur vers un DWORD qui contient le contrôle status de l’appareil. La valeur de contrôle status contient 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 du périphérique 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 GetStatus de l’interface IMDSPDevice associée pour obtenir des informations plus détaillées.
Vous ne devez pas essayer 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 des valeurs de status.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |