Partager via

MÉTHODE IMDSPStorageGlobals ::GetStatus (mswmdm.h)

  • Article

La méthode GetStatus récupère la status actuelle du support de stockage.

Syntaxe

HRESULT GetStatus(
  [out] DWORD *pdwStatus
);

Paramètres

[out] pdwStatus

Pointeur vers un DWORD contenant les informations status. Les valeurs status suivantes peuvent être retournées par le paramètre pdwStatus.

Statut Description
WMDM_STATUS_READY Le support est dans un état prêt inactif.
WMDM_STATUS_BUSY Une opération est en cours. Évaluez status valeurs pour déterminer l’opération en cours.
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 IMDSPStorageGlobals .
WMDM_STATUS_STORAGE_INITIALIZING L’appareil est actuellement occupé à mettre en forme le média sur un appareil.
WMDM_STATUS_STORAGE_BROKEN Le médium est cassé. Pour les appareils qui prennent en charge plusieurs supports, cette valeur est signalée uniquement à partir de l’interface IMDSPStorageGlobals .
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 uniquement retournée à partir de l’interface IMDSPStorageGlobals .
WMDM_STATUS_STORAGE_UNFORMATTED Le support n’est pas mis en forme. Pour les appareils qui prennent en charge plusieurs supports, cette valeur est signalée uniquement à partir de l’interface IMDSPStorageGlobals .

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
Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Vous devez toujours appeler cette méthode avant d’essayer d’interagir avec un support de stockage. La valeur status retournée est WMDM_STATUS_BUSY si une autre interface a appelé une opération en cours. Vous pouvez évaluer la valeur retournée par cet appel pour déterminer si une opération en cours a été appelée à partir de l’interface IMDSPStorageGlobals .

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

Voir aussi

IMDSPStorageGlobals, interface