status 命令

  • 發行項

注意

無偏差通訊 Microsoft 支援多元且包容性的環境。 在本檔中，有 'slave' 這個字的參考。 Microsoft Bias-Free 通訊的樣式指南 會將這視為排除字組。 此文字是用來做為命令內目前使用的文字。 為了一致性，本檔包含此字。 在命令中更改此字時，我們會更正此檔以對齊方式。

status 命令會向裝置要求狀態資訊。 所有裝置都會辨識此命令。

若要傳送此命令，請使用lpszCommand參數集呼叫mciSendString函式，如下所示。

_stprintf_s(
  lpszCommand,
  TEXT("status %s %s %s"),
  lpszDeviceID,
  lpszRequest,
  lpszFlags
);

參數

lpszDeviceID

MCI 裝置的識別碼。 開啟裝置時，會指派此識別碼或別名。

lpszRequest

要求狀態資訊的旗標。 下表列出可辨識 狀態 命令的裝置類型，以及每種類型所使用的旗標。

裝置類型 要求旗標
cdaudio
  • cdaudio 類型追蹤 編號
  • 目前曲目
  • 長度
  • 長度追蹤 編號
  • 媒體簡報
  • mode
  • 曲目數目
  • position
  • 位置追蹤 編號
  • 準備
  • 開始位置
  • 時間格式
digitalvideo
  • 音訊
  • 音訊對齊
  • 音訊 bitspersample
  • 音訊中斷
  • audio bytespersec
  • 音訊輸入
  • 音訊記錄
  • 音訊來源
  • 音訊範例persec
  • 音訊資料流程
  • 低音
  • bitsperpel
  • 亮度
  • color
  • 對比
  • 目前曲目
  • 磁碟空間 磁片磁碟機
  • 檔案完成
  • 檔案格式
  • 檔案模式
  • forward
  • 已略過畫面格
  • gamma
  • input
  • 左音量
  • 長度
  • 長度追蹤 編號
  • 媒體簡報
  • mode
  • monitor
  • monitor 方法
  • 名義
  • 標號畫面播放速率
  • 標稱記錄畫面播放速率
  • 曲目數目
  • output
  • 調色盤控點
  • 暫停模式
  • 播放速度
  • position
  • 位置追蹤 編號
  • 準備
  • 記錄畫面播放速率
  • 參考 框架
  • 保留大小
  • 右磁片區
  • 完全搜尋
  • 清晰度
  • smpte
  • 速度
  • 開始位置
  • 仍然檔案格式
  • 時間格式
  • 色調
  • 高音
  • 未儲存
  • 影片
  • 影片索引鍵索引
  • 視訊按鍵色彩
  • 視訊錄製
  • 視訊來源
  • 視訊來源號碼
  • 視訊串流
  • 磁碟區
  • 視窗控制碼
  • 視窗可見
  • 視窗最小化
  • 視窗最大化
overlay
  • 媒體簡報
  • mode
  • 曲目數目
  • 準備
  • Stretch - 自動縮放
  • 視窗控制碼
排序器
  • 目前曲目
  • 除法類型
  • 長度
  • 長度追蹤 編號 主圖形
  • 媒體簡報
  • mode
  • 曲目數目
  • Offset
  • 連接埠
  • position
  • 位置追蹤 編號
  • 準備
  • 奴隸
  • 開始位置
  • 節奏
  • 時間格式
錄影機
  • 組合記錄
  • 音訊監視器
  • 音訊監視器號碼
  • 音訊記錄
  • 音訊錄製曲 目號碼
  • 音訊來源
  • 音訊來源號碼
  • 通道
  • 通道微調器 號碼
  • 時鐘
  • 時鐘識別碼
  • counter
  • 計數器格式
  • 計數器解析
  • 目前曲目
  • 畫面播放速率
  • 索引
  • index on
  • 長度
  • 長度追蹤 編號
  • 媒體簡報
  • 媒體類型
  • mode
  • 曲目數目
  • 曲目數目
  • 視訊播放軌數目
  • 暫停 逾時
  • 播放格式
  • position
  • position start
  • 位置追蹤 編號
  • 後置註冊 持續時間
  • 開啟電源
  • 預先註冊 持續時間
  • 準備
  • 記錄格式
  • 速度
  • 時間格式
  • 時間模式
  • 時間類型
  • timecode present
  • timecode 記錄
  • timecode 類型
  • 微調器編號
  • 視訊監視器
  • 視訊監視器號碼
  • 視訊錄製
  • 視訊錄製曲目 號碼
  • 視訊來源
  • 視訊來源號碼
  • 寫入受保護
videodisc
  • 目前曲目
  • 光碟大小
  • forward
  • 長度
  • 長度追蹤 編號
  • 媒體簡報
  • 媒體類型
  • mode
  • 曲目數目
  • position
  • 位置追蹤 編號
  • 準備
  • 一邊
  • 速度
  • 開始位置
  • 時間格式
waveaudio
  • 對齊
  • bitspersample
  • bytespersec
  • 通道
  • 目前曲目
  • format tag
  • input
  • 長度
  • 長度追蹤 編號
  • 等級
  • 媒體簡報
  • mode
  • 曲目數目
  • output
  • position
  • 位置追蹤 編號
  • 準備
  • samplespersec
  • 開始位置
  • 時間格式

下表列出可以在 lpszRequest 參數及其意義中指定的旗標。

值 意義
對齊 傳回資料區塊對齊，以位元組為單位。
組合記錄 如果裝置設定為組合模式錄製，則會傳回 TRUE 。
音訊 根據最新的 setaudio 「on」 或 「off」 命令，傳回 「on」 或 「off」。 如果啟用或兩個喇叭，則會傳回「開啟」，否則會傳回「關閉」。
音訊對齊 傳回相對於輸入電壓音訊資料開始的資料區塊對齊方式。
音訊 bitspersample 傳回裝置用於錄製的每個範例位數。 此旗標僅適用于支援「pcm」 演算法的裝置。
音訊中斷 傳回最後一個 AVI 序列音訊部分中斷的次數。 每當系統嘗試將音訊資料寫入設備磁碟機，併發現驅動程式已播放所有可用的資料時，系統都會計算音訊中斷。 此旗標只能由 MCIAVI 數位視訊驅動程式辨識。 它僅供效能評估之用;傳回值很難解譯。
audio bytespersec 傳回用於錄製的每秒位元組平均數目。
音訊輸入 傳回類比輸入音訊訊號的近似即時音訊層級。 大於 1000 的值表示裁剪失真。 有些裝置只能在錄製音訊時傳回此值。 值沒有相關聯的 set 或 setaudio 命令。
音訊監視器 傳回 「output」，或其中一個有效的來源輸入類型。 如需詳細資訊，請參閱 setaudio 「monitor」 命令。
音訊監視器號碼 傳回 狀態 「音訊監視器」所指定類型的受監視視訊編號。 如需詳細資訊，請參閱 setaudio 命令。
音訊記錄 會傳回 「on」 或 「off」，反映 setaudio 「record」 所設定的狀態。
音訊錄製曲 目號碼 如果 VCR 設定為錄製音訊，則會傳回 TRUE 。 如果未指定追蹤編號，則會假設預設值為 1。
音訊範例persec 傳回每秒記錄的樣本數目。
音訊來源 傳回目前的音訊數位板來源：「left」、「right」、「average」 或 「stereo」。
音訊來源號碼 傳回 狀態 「音訊來源」所傳回之型別的音訊來源號碼。 如需詳細資訊，請參閱 setaudio 命令。
音訊資料流程 傳回目前的音訊資料流程編號。
低音 傳回目前的音訊基底層級。
bitsperpel 傳回每圖元儲存擷取或記錄資料的位數。
bitspersample 傳回每個樣本的位。
亮度 傳回目前的視訊亮度等級。
bytespersec 傳回每秒播放或錄製的平均位元組數目。
cdaudio 類型追蹤 編號 傳回指定之追蹤編號的類型。 這可以是「音訊」或「其他」。
通道 傳回微調器上設定之通道的整數值。
通道微調器 號碼 如果指定 「tuner」 數位 ，則會傳回邏輯微調器 編號 上目前選取的通道。 請注意，有數個邏輯微調器。
通道 傳回單聲道設定 (1 的通道數目，2 表示身歷聲) 。
時鐘 傳回外部時間。 時間必須是不帶正負號的長整數，表示總增量。 如需詳細資訊，請參閱 功能 「時鐘遞增速率」命令。
時鐘識別碼 傳回識別時鐘的唯一整數。
color 傳回目前的色彩層級。
對比 傳回目前的對比層級。
counter 以目前的計數器格式傳回計數器位置。
計數器格式 傳回目前的計數器格式。 如需詳細資訊，請參閱 set 「counter format」 命令。
計數器解析 傳回 「frames」 或 「seconds」，表示計數器的解析度。 這與精確度不同。
目前曲目 傳回目前的曲目。MCISEQ 排序器會傳回 1。
磁片大小 傳回 8 或 12，指出載入的磁片大小以英吋為單位。
磁碟空間 磁碟機 傳回目前時間格式的近似磁碟空間，可由指定磁片磁碟機的reserve命令取得。磁片磁碟機通常會指定為單一字母或單一字母，後面接著冒號 (：) 。 不過，有些裝置可能會使用路徑。
除法類型 傳回下列其中一個檔案分割類型：
  • PPQN
  • SMPTE 24 框架
  • SMPTE 25 框架
  • SMPTE 30 置放框架
  • SMPTE 30 框架

使用此資訊來判斷 MIDI 檔案的格式，以及暫存和位置資訊的意義。
檔案完成 傳回 負載、 儲存、 擷取、 剪下、 複製、 刪除、 貼上或 復原 作業的估計百分比。 (應用程式可以使用此功能來提供進度的視覺指標。)
檔案格式 傳回 記錄 或 儲存 命令的目前檔案格式。
檔案模式 傳回 「載入」、「儲存」、「編輯」或「閒置」。 在載入作業期間，它會傳回「載入」。 在 儲存 和 擷取 作業期間，它會傳回「儲存」。 在 剪下、 複製、 刪除、 貼上或 復原 作業期間，它會傳回「編輯」。
格式標記 傳回格式標記。
forward 如果播放方向向前或裝置未播放，則傳回 TRUE 。
畫面播放速率 傳回裝置預設會使用的每秒畫面數。 NTSC 裝置會傳回 30、PAL 25 等等。
略過框架 傳回播放最後一個 AVI 序列時未繪製的畫面數。 此旗標只能由 MCIAVI 數位視訊驅動程式辨識。 它僅供效能評估使用;傳回值難以解譯。
gamma 傳回以 setvideo 「gamma to」 值設定的值。
索引 傳回目前的索引顯示。 如需詳細資訊，請參閱 set 「index」 命令。
索引開啟 如果索引開啟，則傳回 TRUE 。
input 傳回輸入集。 如果未設定錯誤，則傳回的錯誤表示可以使用任何裝置。 針對數位視訊裝置，修改 「bass」、「treble」、「volume」、「brightness」、「color」、「contrast」、「gamma」、「sharpness」 或 「tint」 旗標，使其僅適用于輸入。 這是監視輸入時的預設值。
左磁片區 傳回左側音訊通道的音量集。
長度 傳回目前時間格式的媒體總長度。 針對 PPQN 檔案，長度會以歌曲指標單位傳回。 針對 SMPTE 檔案，它會以 hh：mm：ss：ff傳回，其中 hh 為小時、 mm 為分鐘、 ss 為秒， 而 ff 為框架。 若為 VCR 裝置，長度為 2 小時 (，除非使用 set 命令) 明確變更長度。
長度追蹤 編號 傳回以 數位指定的時間或框架的曲目長度。針對 PPQN 檔案，長度會以歌曲指標單位傳回。 針對 SMPTE 檔案，它會以 hh：mm：ss：ff傳回，其中 hh 為小時、 mm 為分鐘、 ss 為秒， 而 ff 為框架。
等級 傳回目前的 PCM 音訊範例值。
master 根據同步處理集的類型，傳回 「midi」、「none」 或 「smpte」。
媒體簡報 如果媒體插入裝置或 FALSE，則傳回 TRUE 。否則傳回 TRUE 。 時序器、視訊重迭、數位視訊和電壓音訊裝置會傳回 TRUE。
媒體類型 傳回媒體的類型。 針對 VCRS，這是 「8mm」、「vhs」、「svhs」、「Beta」、「Hi8」、「edBeta」 或 「other」。 對於 videodiscs，這是視視訊磁片類型而定的 「CAV」、「CLV」 或 「other」。
mode 傳回裝置的目前模式。 所有裝置都可以傳回「尚未就緒」、「已暫停」、「現正播放」和「已停止」值。 有些裝置可以傳回其他「開啟」、「停駐」、「錄製」和「搜尋」值。
monitor 傳回 「file」 或 「input」。 傳回的值表示目前的簡報來源。
monitor 方法 傳回 「pre」、「post」 或 「direct」。 傳回的值表示用於輸入監視的方法。
名義 專案會修改 「bass」、「brightness」、「color」、「contrast」、「gamma」、「sharpness」、「tint」、「treble」 和 「volume」 旗標，以傳回標準值，而不是目前的設定。
標準畫面播放速率 傳回與檔案相關聯的標準畫面播放速率。 單位每秒的畫面數乘以 1000。
標準記錄畫面播放速率 傳回與輸入視訊訊號相關聯的標準畫面播放速率。 單位每秒的畫面數乘以 1000。
音訊播放軌數目 傳回媒體上的音訊播放軌數目。
曲目數目 傳回媒體上的曲目數目。 MCISEQ 和 MCIWAVE 裝置會傳回 1，如同大部分的 VCR 裝置一樣。 MCIPIONR 裝置不支援此旗標。
視訊播放軌數目 傳回媒體上的視訊播放軌數目。
Offset 傳回以 SMPTE 為基礎的檔案位移。 位移是以 SMPTE 為基礎的序列開始時間。 時間會以 hh：mm：ss：ff傳回，其中 hh 是小時、 mm 是分鐘、 ss 是秒， 而 ff 是框架。
output 傳回目前設定的輸出。 如果未設定任何輸出，則傳回的錯誤表示可以使用任何裝置。 針對數位視訊裝置，修改 「bass」、「treble」、「volume」、「brightness」、「color」、「contrast」、「gamma」、「sharpness」 或 「tint」 旗標，使其僅適用于輸出。 這是監視檔案時的預設值。
暫停模式 如果裝置在錄製時暫停，則會傳回「錄製」。 如果裝置在播放時暫停，則會傳回「現正播放」。 如果裝置未暫停，則會傳回「動作不適用於目前模式」錯誤。
暫停逾時 傳回 暫停 命令的最大持續時間，以毫秒為單位。
播放格式 傳回程序代碼，指出如果可偵測到，將會播放影片播放的格式：「lp」、「ep」、「sp」 或 「other」。 如需詳細資訊，請參閱旗標。
播放速度 傳回值，表示最後一個 AVI 序列的實際播放時間與目標播放時間的比對程度。 值 1000 表示目標時間和實際時間相同。 例如，值為 2000，表示 AVI 序列花費兩倍的時間，就如同它應該一樣播放。 此旗標只能由 MCIAVI 數位視訊驅動程式辨識。 它僅供效能評估之用;傳回值很難解譯。
連接埠 傳回指派給序列的 MIDI 埠號碼。
position 傳回目前的位置。對於 PPQN 檔案，位置會以歌曲指標單位傳回。 對於 SMPTE 檔案，它會以 hh：mm：ss：ff傳回，其中 hh 是小時， mm 是分鐘，ss 是秒， 而 ff 是框架。
position start 傳回可用媒體開頭的位置。
位置追蹤 編號 傳回依 數位指定之曲目開始的位置。 對於 PPQN 檔案，時間格式會以歌曲指標單位傳回。 對於 SMPTE 檔案，它會以 hh：mm：ss：ff傳回，其中 hh 是小時， mm 是分鐘， ss 是秒， 而 ff 是框架。 MCISEQ 排序器會傳回零。 MCIPIONR 裝置不支援此旗標。 MCIWAVE 裝置會傳回零。
後置註冊持續時間 傳回發出 停止 或暫停命令時，需要目前時間格式的視訊播放片長度，以停止或 暫停 命令來停止 VCR 傳輸。
開啟電源 如果 VCR 的電源開啟，則會傳回 TRUE 。
預先註冊持續時間 以目前時間格式傳回穩定 VCR 輸出所需的視訊工作長度。
準備 如果裝置已準備好接受另一個命令，則會傳回 TRUE 。
記錄格式 傳回程序代碼，指出將錄製影片的格式。 目前的傳回類型為 「lp」、「ep」、「sp」 或 「other」。 這些格式並非 VHS 特定格式，而且可以套用至具有多個可選取錄製格式的任何 VCR。 「sp」 類型是最快、高品質的錄製格式，並做為單一格式 VCR 的預設值。
記錄畫面播放速率 傳回畫面播放速率，每秒的畫面格數乘以 1000，用於壓縮。
參考 框架 傳回最接近指定畫面格之前之主要 畫面格影像的畫面編號。
保留大小 傳回保留工作區目前時間格式的大小。 大小會對應到從完整工作區播放壓縮資料所需的時間。 如果沒有保留的磁碟空間，則會傳回零。 此旗標會傳回近似大小，因為壓縮資料的精確磁碟空間通常無法在壓縮資料之後預測。
右磁片區 傳回正確音訊通道的音量集。
samplespersec 傳回每秒播放或錄製的樣本數目。
完全搜尋 會傳回 「on」 或 「off」，指出是否已設定 「seek exactly」 旗標。
清晰度 傳回裝置目前的尖角等級。
一邊 會傳回 1 或 2，表示載入 videodisc 的哪一端。
奴隸 根據同步處理集的類型傳回 「file」、「midi」、「none」 或 「smpte」。
smpte 傳回與工作區中目前位置相關聯的 SMPTE 時間碼。 這是格式為 dd：dd：dd：dd 的字串， 其中每個 d 代表 0 到 9 的數位。 如果工作區資料不包含 timecode 資料，則此旗標會傳回 00：00：00：00。
速度 以每秒畫面格為單位傳回裝置的目前速度， (或 設定 「speed」 命令所使用的相同格式) 。 MCIPIONR 視訊disc 播放機不支援此旗標。
開始位置 傳回媒體的起始位置。
仍然檔案格式 傳回 擷取 命令目前的檔案格式。
Stretch - 自動縮放 如果已啟用延展，則會傳回 TRUE 。
節奏 傳回目前時間格式之 MIDI 序列的目前暫存。 對於具有 PPQN 格式的檔案，tempo 每分鐘會按一次。 對於 SMPTE 格式的檔案，tempo 是每秒的畫面格。
時間格式 傳回目前的時間格式。 如需詳細資訊，請參閱 set 命令中的時間格式。
時間模式 傳回目前的位置時間模式。 它可以是 「detect」、「timecode」 或 「counter」。
時間類型 傳回目前使用中的位置時間：「timecode」 或 「counter」。
timecode present 如果時間碼已記錄在磁帶上目前的位置，則會傳回 TRUE 。 timecode 必須從目前的位置前進。 VCR 可能需要播放，才能檢查此條件。
timecode 記錄 如果 VCR 設定為記錄時間代碼，則傳回 TRUE 。
timecode 類型 傳回 「smpte」、「smpte drop」、「other」 或 「none」。 請注意，每秒的畫面格可以從狀態「畫面播放速率」命令取得，而裝置的精確度可由 「 搜尋精確度」命令傳回。
色調 傳回目前的視訊色調層級。
高音 傳回目前的音訊高階。
tuner number 傳回目前的邏輯微調器編號。
未儲存 如果工作區中有記錄的資料可能會因為關閉、載入、記錄、保留、剪下、刪除或貼上命令而遺失，則會傳回TRUE。 否則會傳回 FALSE 。
影片 會傳回 「on」 或 「off」，反映 setvideo 命令所設定的狀態。
視訊按鍵色彩 傳回索引鍵色彩的值。
影片索引鍵索引 傳回索引鍵索引的值。
視訊監視器 傳回「輸出」或其中一個有效的來源輸入類型。 如需詳細資訊，請參閱 setvideo 「monitor」 命令。
視訊監視器號碼 傳回狀態為「影片監視器」所傳回之類型的受監視視訊編號。 如需詳細資訊，請參閱 setvideo 命令。
視訊錄製 會傳回 「on」 或 「off」，反映 setvideo 「record」 所設定的目前狀態。
視訊錄製曲目 編號 如果 VCR 設定為錄製影片，則傳回 TRUE 。 如果未指定追蹤編號，則會假設預設值為 1。
視訊來源 傳回視訊來源類型。 如需詳細資訊，請參閱 setvideo 命令。
視訊來源號碼 傳回與使用中型別之視訊來源對應的數位。 例如，如果使用第二個 NTSC 視訊來源輸入，則會傳回 2。
視訊串流 傳回目前的視訊資料流程編號。
磁碟區 傳回左右喇叭的平均音量。 如果裝置尚未播放或尚未設定磁片區，這會傳回錯誤。
視窗控制碼 以傳回值的低序字，傳回視窗控制碼的 ASCII 十進位值。
視窗最大化 如果視窗最大化，則會傳回 TRUE 。
視窗最小化 如果視窗最小化，則會傳回 TRUE 。
視窗可見 如果視窗未隱藏，則會傳回 TRUE 。
寫入受保護 如果裝置偵測到無法記錄 (，則傳回 TRUE ，也就是如果寫入保護是在) 上。 如果它可以記錄，或者如果無法判斷它是否可以記錄 (而不實際寫入) ，驅動程式會傳回 FALSE。

lpszFlags

可以是 「wait」、「notify」 或兩者。 對於數位視訊和 VCR 裝置，也可以指定「測試」。 如需這些旗標的詳細資訊，請參閱 Wait、Notify 和 Test Flags。

傳回值

傳回mciSendString之lpszReturnString參數中的資訊。 資訊取決於要求類型。

備註

發出任何使用位置值的命令之前，您應該使用 set 命令來設定所需的時間格式。

範例

下列命令會傳回 「mysound」 裝置的目前模式。

status mysound mode

規格需求

需求 值
最低支援的用戶端
 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限傳統型應用程式]

另請參閱

Mci

MCI 命令字串

capability

捕獲

close

削減

delete

載入

pause

粘貼

record

儲備

儲存

set

setaudio

setvideo

停止

復原