Share via

MÉTHODE IMDSPDeviceControl ::GetDCStatus (mswmdm.h)

  • Article

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
 S_OK
E_INVALIDARG
 Le paramètre pdwStatus est un pointeur non valide ou NULL .
E_FAIL
 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

Voir aussi

IMDSPDeviceControl, interface