Método IWMDMStorageGlobals::GetStatus (mswmdm.h)
El método GetStatus recupera el estado actual de un medio de almacenamiento.
Sintaxis
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Parámetros
[out] pdwStatus
Puntero a un DWORD para recibir la información de estado cuando el método devuelve. Los valores siguientes se pueden devolver en el parámetro pdwStatus .
Estado | Descripción |
---|---|
WMDM_STATUS_READY | El medio está en estado inactivo o listo. |
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 de almacenamiento no está presente. En el caso de los dispositivos con más de un medio admitido, este valor solo se notifica desde la interfaz IWMDMStorageGlobals . |
WMDM_STATUS_STORAGE_INITIALIZING | El dispositivo está ocupado actualmente para dar formato a un medio de almacenamiento en un dispositivo. |
WMDM_STATUS_STORAGE_BROKEN | El medio de almacenamiento está roto. En el caso de los dispositivos con más de un medio admitido, este valor solo se notifica desde la interfaz IWMDMStorageGlobals . |
WMDM_STATUS_STORAGE_NOTSUPPORTED | El dispositivo no admite el medio de almacenamiento. En el caso de los dispositivos con más de un medio admitido, este valor solo se devuelve desde la interfaz IWMDMStorageGlobals . |
WMDM_STATUS_STORAGE_UNFORMATTED | El medio de almacenamiento no tiene formato. En el caso de los dispositivos con más de un medio admitido, este valor solo se notifica desde la interfaz IWMDMStorageGlobals . |
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
Comentarios
Siempre se debe llamar a este método antes de que el autor de la llamada intente interactuar con un medio de almacenamiento. El valor de estado recuperado es WMDM_STATUS_BUSY si alguna otra interfaz ha invocado una operación en curso. Puede evaluar el valor recuperado de esta llamada para determinar si se ha invocado una operación en curso desde la interfaz IWMDMStorageGlobals .
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | mswmdm.h |
Library | Mssachlp.lib |