IWMDMDeviceControl：：GetStatus 方法 (mswmdm.h)
GetStatus 方法會擷取裝置的控制狀態。
語法
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
參數
[out] pdwStatus
指定裝置控制項狀態的 DWORD 指標。 控件狀態值會指定下列一或多個旗標。
| 旗標 | 描述 |
|---|---|
| WMDM_STATUS_READY | Windows Media 裝置管理員 及其子元件處於就緒狀態。 |
| WMDM_STATUS_BUSY | 目前正在執行作業。 評估其他狀態值，以判斷其為哪個作業。 |
| WMDM_STATUS_DEVICECONTROL_PLAYING | 裝置目前正在播放。 |
| WMDM_STATUS_DEVICECONTROL_RECORDING | 裝置目前正在錄製。 |
| WMDM_STATUS_DEVICECONTROL_PAUSED | 裝置目前已暫停。 |
| WMDM_STATUS_DEVICECONTROL_REMOTE | 裝置的播放或錄製作業正由應用程式遠端控制。 |
| WMDM_STATUS_DEVICECONTROL_STREAM | 播放或記錄方法會將數據串流至媒體裝置或從媒體裝置進行串流處理。 |
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼 | 描述 |
|---|---|
|
此方法已成功。 |
|
pdwStatus 參數是無效或 NULL 指標。 |
|
發生未指定的錯誤。 |
備註
此呼叫會傳回這個介面之裝置控制作業特定的狀態值。 控件狀態可以提供裝置之控件相關活動狀態的相關信息，例如播放、錄製等等。 不過，它無法提供裝置全域狀態的相關信息，例如裝置正在下載數據或基於其他原因存取。 如果裝置因為裝置控制以外的任何原因而忙碌，您會收到忙碌的程序代碼，而且必須呼叫 IWMDMDeviceControl：：GetStatus 方法以取得詳細資訊。
如果傳回狀態值WMDM_STATUS_BUSY，且狀態值不包含狀態值數據表的任何其他值，則您不得嘗試呼叫此介面的 Play、 Record、 Pause、 Resume 或 Stop 方法。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | mswmdm.h |
| 程式庫 | Mssachlp.lib |