共用方式為

IMDSPDeviceControl：：GetDCStatus 方法 (mswmdm.h)

  • 發行項

GetDCStatus 方法會擷取裝置的控件狀態。

語法

HRESULT GetDCStatus(
  [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。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。
E_INVALIDARG
 pdwStatus 參數是無效或 NULL 指標。
E_FAIL
 發生未指定的錯誤。

備註

此呼叫會傳回這個介面之裝置控制作業特有的狀態值。 控件狀態可以提供裝置控制件相關活動狀態的相關信息，例如播放、錄製等等。 不過，它無法提供裝置全域狀態的相關信息，例如裝置正在下載數據或基於其他原因而存取。 如果裝置因裝置控制以外的任何原因而忙碌，您會收到忙碌的程序代碼，而且必須呼叫相關聯 IMDSPDevice 介面的 GetStatus 方法，以取得詳細資訊。

如果傳回狀態值WMDM_STATUS_BUSY狀態值，而且狀態值不包含來自狀態值數據表的任何其他值，則不得嘗試呼叫此介面的 Play、 Record、 Pause、 Resume 或 Stop 方法。

規格需求

需求 值
目標平台 Windows
標頭 mswmdm.h
程式庫 Mssachlp.lib

另請參閱

IMDSPDeviceControl 介面