Compartir a través de

Método IMDSPStorageGlobals::GetStatus (mswmdm.h)

  • Artículo

El método GetStatus recupera el estado actual del medio de almacenamiento.

Sintaxis

HRESULT GetStatus(
  [out] DWORD *pdwStatus
);

Parámetros

[out] pdwStatus

Puntero a un DWORD que contiene la información de estado. El parámetro pdwStatus puede devolver los siguientes valores de estado.

Estado Descripción
WMDM_STATUS_READY El medio está en un estado listo para estar inactivo.
WMDM_STATUS_BUSY Una operación está en curso. Evalúe los valores de estado para determinar la operación en curso.
WMDM_STATUS_STORAGE_NOTPRESENT El medio no está presente. En el caso de los dispositivos que admiten más de un medio, este valor solo se notifica desde la interfaz IMDSPStorageGlobals .
WMDM_STATUS_STORAGE_INITIALIZING El dispositivo está ocupado actualmente con formato multimedia en un dispositivo.
WMDM_STATUS_STORAGE_BROKEN El medio está roto. En el caso de los dispositivos que admiten más de un medio, este valor solo se notifica desde la interfaz IMDSPStorageGlobals .
WMDM_STATUS_STORAGE_NOTSUPPORTED El medio no es compatible con el dispositivo. En el caso de los dispositivos que admiten más de un medio, este valor solo se devuelve de la interfaz IMDSPStorageGlobals .
WMDM_STATUS_STORAGE_UNFORMATTED El medio no tiene formato. En el caso de los dispositivos que admiten más de un medio, este valor solo se notifica desde la interfaz IMDSPStorageGlobals .

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

  • Códigos de error COM estándar
  • Códigos de error de Windows convertidos en valores HRESULT
  • Códigos de error de windows Media Administrador de dispositivos
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Siempre debe llamar a este método antes de intentar interactuar con un medio de almacenamiento. El valor de estado devuelto es WMDM_STATUS_BUSY si alguna otra interfaz ha invocado una operación en curso. Puede evaluar el valor devuelto desde esta llamada para determinar si se ha invocado una operación en curso desde la interfaz IMDSPStorageGlobals .

Este método debe implementarse. No debe devolver WMDM_E_NOTSUPPORTED ni E_NOTIMPL. Para obtener más información, consulte Interfaces obligatorias y opcionales.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado mswmdm.h
Library Mssachlp.lib

Consulte también

Interfaz IMDSPStorageGlobals