Compartir a través de

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

  • Artículo

El método GetStatus recupera toda la información de estado del dispositivo que el dispositivo puede proporcionar.

Sintaxis

HRESULT GetStatus(
  [out] DWORD *pdwStatus
);

Parámetros

[out] pdwStatus

Puntero a un DWORD que recibe el estado actual del dispositivo. Estos valores de estado se definen en la tabla siguiente.

Estado Descripción
WMDM_STATUS_READY Windows Media Administrador de dispositivos y sus subcomponentes están en un estado listo.
WMDM_STATUS_BUSY Una operación está en curso. Compruebe otros valores de estado para determinar qué operación es.
WMDM_STATUS_DEVICE_NOTPRESENT El dispositivo no está conectado al equipo.
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 IWMDMStorageGlobals .
WMDM_STATUS_STORAGE_INITIALIZING El dispositivo está ocupado actualmente con formato multimedia en el dispositivo.
WMDM_STATUS_STORAGE_BROKEN El medio no funciona. En el caso de los dispositivos que admiten más de un medio, este valor solo se notifica desde la interfaz IWMDMStorageGlobals .
WMDM_STATUS_STORAGE_NOTSUPPORTED El dispositivo no admite el medio. En el caso de los dispositivos que admiten más de un medio, este valor solo se devuelve desde la interfaz IWMDMStorageGlobals .
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 devuelve desde la interfaz IWMDMStorageGlobals .
WMDM_STATUS_STORAGECONTROL_INSERTING El método IWMDMStorageControl::Insert se está ejecutando actualmente.
WMDM_STATUS_STORAGECONTROL_DELETING El método IWMDMStorageControl::D elete se está ejecutando actualmente.
WMDM_STATUS_STORAGECONTROL_MOVING El método IWMDMStorageControl::Move se está ejecutando actualmente.
WMDM_STATUS_STORAGECONTROL_READING El método IWMDMStorageControl::Read se está ejecutando actualmente.

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

Se pueden devolver uno o varios valores de estado desde esta llamada. Todos los valores de estado de todas las interfaces del dispositivo multimedia se notifican a través de esta llamada. Por ejemplo, si una operación de almacenamiento, como escribir un archivo en un dispositivo multimedia está en curso, una llamada a este método informa del estado ocupado de esa operación. Para cualquier operación en curso, el valor de estado WMDM_STATUS_BUSY siempre está presente.

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 IMDSPDevice

Interfaz IWMDMStorageControl

Interfaz IWMDMStorageGlobals