MÉTHODE IMDSPDevice ::GetStatus (mswmdm.h)
La méthode GetStatus récupère toutes les informations status de l’appareil que l’appareil peut fournir.
Syntaxe
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Paramètres
[out] pdwStatus
Pointeur vers un DWORD qui reçoit l’appareil actuel status. Ces valeurs status sont définies dans le tableau suivant.
| Statut | 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. Vérifiez les autres valeurs status pour déterminer de quelle opération il s’agit. |
| WMDM_STATUS_DEVICE_NOTPRESENT | L’appareil n’est pas connecté à l’ordinateur. |
| WMDM_STATUS_STORAGE_NOTPRESENT | Le support n’est pas présent. Pour les appareils qui prennent en charge plusieurs supports, cette valeur est signalée uniquement à partir de l’interface IWMDMStorageGlobals . |
| WMDM_STATUS_STORAGE_INITIALIZING | L’appareil est actuellement occupé à mettre en forme le média sur l’appareil. |
| WMDM_STATUS_STORAGE_BROKEN | Le support ne fonctionne pas. Pour les appareils qui prennent en charge plusieurs supports, cette valeur est signalée uniquement à partir de l’interface IWMDMStorageGlobals . |
| WMDM_STATUS_STORAGE_NOTSUPPORTED | Le support n’est pas pris en charge par l’appareil. Pour les appareils qui prennent en charge plusieurs supports, cette valeur est retournée uniquement à partir de l’interface IWMDMStorageGlobals . |
| WMDM_STATUS_STORAGE_UNFORMATTED | Le support n’est pas mis en forme. Pour les appareils qui prennent en charge plusieurs supports, cette valeur est retournée uniquement à partir de l’interface IWMDMStorageGlobals . |
| WMDM_STATUS_STORAGECONTROL_INSERTING | La méthode IWMDMStorageControl ::Insert est en cours d’exécution. |
| WMDM_STATUS_STORAGECONTROL_DELETING | La méthode IWMDMStorageControl ::D elete est en cours d’exécution. |
| WMDM_STATUS_STORAGECONTROL_MOVING | La méthode IWMDMStorageControl ::Move est en cours d’exécution. |
| WMDM_STATUS_STORAGECONTROL_READING | La méthode IWMDMStorageControl ::Read est en cours d’exécution. |
Valeur retournée
Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes suivantes de codes d’erreur :
- Codes d’erreur COM standard
- Codes d’erreur Windows convertis en valeurs HRESULT
- Codes d’erreur Gestionnaire de périphériques Windows Media
Remarques
Une ou plusieurs valeurs status peuvent être retournées à partir de cet appel. Toutes les valeurs status de toutes les interfaces de l’appareil multimédia sont signalées par le biais de cet appel. Par exemple, si une opération de stockage, telle que l’écriture d’un fichier sur un périphérique multimédia, est en cours, un appel à cette méthode signale la status occupée de cette opération. Pour toute opération en cours, la valeur status WMDM_STATUS_BUSY est toujours présente.
Cette méthode doit être implémentée. Il ne doit pas retourner WMDM_E_NOTSUPPORTED ni E_NOTIMPL. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |