Metodo IMDSPDevice::GetStatus (mswmdm.h)
Il metodo GetStatus recupera tutte le informazioni sullo stato del dispositivo che il dispositivo può fornire.
Sintassi
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Parametri
[out] pdwStatus
Puntatore a un DWORD che riceve lo stato corrente del dispositivo. Questi valori di stato sono definiti nella tabella seguente.
| Stato | Descrizione |
|---|---|
| WMDM_STATUS_READY | Windows Media Gestione dispositivi e i relativi sottocomponenti sono in uno stato pronto. |
| WMDM_STATUS_BUSY | Un'operazione è in corso. Controllare altri valori di stato per determinare quale operazione è. |
| WMDM_STATUS_DEVICE_NOTPRESENT | Il dispositivo non è connesso al computer. |
| WMDM_STATUS_STORAGE_NOTPRESENT | Il supporto non è presente. Per i dispositivi che supportano più di un supporto, questo valore viene segnalato solo dall'interfaccia IWMDMStorageGlobals . |
| WMDM_STATUS_STORAGE_INITIALIZING | Il dispositivo è attualmente occupato nella formattazione dei supporti nel dispositivo. |
| WMDM_STATUS_STORAGE_BROKEN | Il supporto non funziona. Per i dispositivi che supportano più di un supporto, questo valore viene segnalato solo dall'interfaccia IWMDMStorageGlobals . |
| WMDM_STATUS_STORAGE_NOTSUPPORTED | Il supporto non è supportato dal dispositivo. Per i dispositivi che supportano più di un supporto, questo valore viene restituito solo dall'interfaccia IWMDMStorageGlobals . |
| WMDM_STATUS_STORAGE_UNFORMATTED | Il supporto non è formattato. Per i dispositivi che supportano più di un supporto, questo valore viene restituito solo dall'interfaccia IWMDMStorageGlobals . |
| WMDM_STATUS_STORAGECONTROL_INSERTING | Il metodo IWMDMStorageControl::Insert è attualmente in esecuzione. |
| WMDM_STATUS_STORAGECONTROL_DELETING | Il metodo IWMDMStorageControl::D elete è attualmente in esecuzione. |
| WMDM_STATUS_STORAGECONTROL_MOVING | Il metodo IWMDMStorageControl::Move è attualmente in esecuzione. |
| WMDM_STATUS_STORAGECONTROL_READING | Il metodo IWMDMStorageControl::Read è attualmente in esecuzione. |
Valore restituito
Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:
- Codici di errore COM standard
- Codici di errore di Windows convertiti in valori HRESULT
- Codici di errore di Windows Media Gestione dispositivi
Commenti
È possibile restituire uno o più valori di stato da questa chiamata. Tutti i valori di stato di tutte le interfacce del dispositivo multimediale vengono segnalati tramite questa chiamata. Ad esempio, se un'operazione di archiviazione, ad esempio la scrittura di un file in un dispositivo multimediale è in corso, una chiamata a questo metodo segnala lo stato occupato di tale operazione. Per qualsiasi operazione in corso, il valore di stato WMDM_STATUS_BUSY è sempre presente.
Questo metodo deve essere implementato. Non deve restituire WMDM_E_NOTSUPPORTED o E_NOTIMPL. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |