Metodo IWMDMDeviceControl::GetStatus (mswmdm.h)
Il metodo GetStatus recupera lo stato del controllo del dispositivo.
Sintassi
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Parametri
[out] pdwStatus
Puntatore a un DWORD che specifica lo stato del controllo del dispositivo. Il valore di stato del controllo specifica uno o più dei flag seguenti.
| Flag | Descrizione |
|---|---|
| WMDM_STATUS_READY | Windows Media Gestione dispositivi e i relativi sottocomponenti sono in uno stato pronto. |
| WMDM_STATUS_BUSY | È in corso l'esecuzione di un'operazione. Valutare gli altri valori di stato per determinare quale operazione si tratta. |
| WMDM_STATUS_DEVICECONTROL_PLAYING | Il dispositivo è attualmente in riproduzione. |
| WMDM_STATUS_DEVICECONTROL_RECORDING | Il dispositivo sta attualmente registrando. |
| WMDM_STATUS_DEVICECONTROL_PAUSED | Il dispositivo è attualmente sospeso. |
| WMDM_STATUS_DEVICECONTROL_REMOTE | L'operazione di riproduzione o registrazione del dispositivo viene controllata in remoto dall'applicazione. |
| WMDM_STATUS_DEVICECONTROL_STREAM | Il metodo di riproduzione o record è lo streaming di dati da o verso il dispositivo multimediale. |
Valore restituito
Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro pdwStatus è un puntatore NULL o non valido. |
|
Si è verificato un errore non specificato. |
Commenti
Questa chiamata restituisce valori di stato specifici per le operazioni di controllo del dispositivo di questa interfaccia. Lo stato del controllo può fornire informazioni sullo stato delle attività correlate al controllo del dispositivo, ad esempio riproduzione, registrazione e così via. Tuttavia, non può fornire informazioni sullo stato globale del dispositivo, ad esempio se il dispositivo sta scaricando i dati o se è stato eseguito l'accesso per qualche altro motivo. Se il dispositivo è occupato per qualsiasi motivo diverso dal controllo del dispositivo, si riceve un codice occupato e deve chiamare il metodo IWMDMDeviceControl::GetStatus per informazioni più dettagliate.
Non è necessario tentare di chiamare i metodi Play, Record, Pause, Resume o Stop di questa interfaccia se viene restituito il valore di stato WMDM_STATUS_BUSY e il valore di stato non contiene altri valori della tabella dei valori di stato.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |