MCI_STATUS命令

  • 發行項

注意

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

MCI_STATUS命令會擷取 MCI 裝置的相關資訊。 所有裝置都會辨識此命令。 資訊會在lpStatus參數所識別之結構的dwReturn成員中傳回。

若要傳送此命令，請使用下列參數呼叫 mciSendCommand 函式。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_STATUS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_STATUS_PARMS) lpStatus
);

參數

wDeviceID

要接收命令訊息之 MCI 裝置的裝置識別碼。

dwFlags

MCI_NOTIFY、MCI_WAIT或數位視訊和 VCR 裝置MCI_TEST。 如需這些旗標的相關資訊，請參閱 Wait、Notify 和 Test Flags。

lpStatus

MCI_STATUS_PARMS結構的指標。 (具有擴充命令集的裝置，可能會以裝置特定的結構取代此結構。)

傳回值

如果成功或發生錯誤，則傳回零。

備註

下列額外的標準和命令特定旗標適用于支援MCI_STATUS的所有裝置：

MCI_STATUS_ITEM

指定lpStatus所識別結構的dwItem成員包含常數，指定要取得的狀態專案。 下列常數會定義結構 dwReturn 成員中要傳回的狀態專案：

MCI_STATUS_CURRENT_TRACK

dwReturn成員會設定為目前的追蹤編號。 MCI 使用連續追蹤編號。

MCI_STATUS_LENGTH

dwReturn成員會設定為媒體長度總計。

MCI_STATUS_MODE

dwReturn成員會設定為裝置的目前模式。 這些模式包括下列各項：

  • MCI_MODE_NOT_READY
  • MCI_MODE_PAUSE
  • MCI_MODE_PLAY
  • MCI_MODE_STOP
  • MCI_MODE_OPEN
  • MCI_MODE_RECORD
  • MCI_MODE_SEEK

MCI_STATUS_NUMBER_OF_TRACKS

dwReturn成員會設定為可播放曲目總數。

MCI_STATUS_POSITION

dwReturn成員會設定為目前的位置。

MCI_STATUS_READY

如果裝置已就緒， dwReturn 成員就會設定為 TRUE ;否則會設定為 FALSE 。

MCI_STATUS_TIME_FORMAT

dwReturn成員會設定為裝置的目前時間格式。 時間格式包括：

  • MCI_FORMAT_BYTES
  • MCI_FORMAT_FRAMES
  • MCI_FORMAT_HMS
  • MCI_FORMAT_MILLISECONDS
  • MCI_FORMAT_MSF
  • MCI_FORMAT_SAMPLES
  • MCI_FORMAT_TMSF

MCI_STATUS_START

取得媒體的開始位置。 若要取得開始位置，請將此旗標與MCI_STATUS_ITEM結合，並將lpStatus所識別結構的dwItem成員設定為MCI_STATUS_POSITION。

MCI_TRACK

表示狀態追蹤參數包含在lpStatus所識別結構的dwTrack成員中。 您必須搭配MCI_STATUS_POSITION或MCI_STATUS_LENGTH常數使用此旗標。 搭配MCI_STATUS_POSITION使用時，MCI_TRACK取得指定曲目的起始位置。搭配MCI_STATUS_LENGTH使用時，MCI_TRACK取得指定曲目的長度。MCI 使用連續追蹤編號。

下列其他旗標會搭配 cdaudio 裝置類型使用。 當為dwFlags參數指定MCI_STATUS_ITEM時，這些常數會用於lpStatus參數所指向結構的dwItem成員中。

MCI_CDA_STATUS_TYPE_TRACK

dwReturn成員會設定為下列其中一個值：

  • MCI_CDA_TRACK_AUDIO
  • MCI_CDA_TRACK_OTHER

若要使用此旗標，必須設定MCI_TRACK旗標，而且lpStatus所識別結構的dwTrack成員必須包含有效的追蹤編號。

MCI_STATUS_MEDIA_PRESENT

如果媒體插入裝置， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

下列其他旗標會搭配 digitalvideo 裝置類型使用：

MCI_DGV_STATUS_DISKSPACE

lpStatus所識別結構的lpstrDrive成員會指定磁片磁碟機，或在某些實作中指定路徑。 MCI_STATUS命令會傳回可由lpStatus所識別結構的dwReturn成員中的MCI_RESERVE命令取得的大約磁碟空間量。 磁碟空間是以目前時間格式的單位來測量。

MCI_DGV_STATUS_INPUT

由 lpStatus所識別結構的dwItem成員指定的常數會套用至輸入。

MCI_DGV_STATUS_LEFT

由 lpStatus所識別結構的dwItem成員指定的常數會套用至左側音訊通道。

MCI_DGV_STATUS_NOMINAL

由 lpStatus所識別之結構的dwItem成員指定的常數會要求標準值，而不是目前的值。

MCI_DGV_STATUS_OUTPUT

由 lpStatus所識別結構的dwItem成員指定的常數會套用至輸出。

MCI_DGV_STATUS_RECORD

針對MCI_DGV_STATUS_FRAME_RATE旗標傳回的畫面播放速率是用於壓縮的速率。

MCI_DGV_STATUS_REFERENCE

lpStatus所識別結構的dwReturn成員會傳回最接近的主要畫面格影像，該影像位於dwReference成員中指定的框架之前。

MCI_DGV_STATUS_RIGHT

由 lpStatus所識別結構的dwItem成員指定的常數會套用至正確的音訊通道。

當為dwFlags參數指定MCI_STATUS_ITEM時，下列常數會與lpStatus參數所指向結構的dwItem成員中的digitalvideo裝置類型搭配使用。

MCI_AVI_STATUS_AUDIO_BREAKS

dwReturn成員會傳回最後一個 AVI 序列音訊部分中斷的次數。 每當系統嘗試將音訊資料寫入設備磁碟機，併發現驅動程式已播放所有可用的資料時，系統都會計算音訊中斷。 此旗標只能由 MCIAVI 數位視訊驅動程式辨識。

MCI_AVI_STATUS_FRAMES_SKIPPED

dwReturn成員會傳回上次播放 AVI 序列時未繪製的畫面數。 此旗標只能由 MCIAVI 數位視訊驅動程式辨識。

MCI_AVI_STATUS_LAST_PLAY_SPEED

dwReturn成員會傳回值，代表最後一個 AVI 序列的實際播放時間與目標播放時間的比對程度。 值 1000 表示目標時間和實際時間相同。 例如，值為 2000，表示 AVI 序列花費兩倍的時間，就如同它應該一樣播放。 此旗標只能由 MCIAVI 數位視訊驅動程式辨識。

MCI_DGV_STATUS_AUDIO

dwReturn成員會根據MCI_SET命令的最新MCI_SET_AUDIO選項傳回MCI_ON或MCI_OFF。 如果或兩個喇叭都已啟用，則會傳回MCI_ON，否則會傳回MCI_OFF。

MCI_DGV_STATUS_AUDIO_INPUT

dwReturn成員會傳回類比音訊訊號的近似即時音訊層級。 大於 1000 的值表示有裁剪失真。 有些裝置只能在錄製音訊時判斷此值。 這個狀態值沒有關聯的 MCI_SET 或 MCI_SETAUDIO 命令。 這個值與MCI_WAVE_STATUS_LEVEL的電壓/音訊命令不同，但與正規化不同。

MCI_DGV_STATUS_AUDIO_RECORD

dwReturn成員會傳回MCI_ON或MCI_OFF反映MCI_SETAUDIO命令MCI_DGV_SETAUDIO_RECORD旗標所設定的狀態。

MCI_DGV_STATUS_AUDIO_SOURCE

dwReturn成員會傳回目前的音訊數位板來源：

MCI_DGV_SETAUDIO_AVERAGE

指定左右音訊通道的平均值。

MCI_DGV_SETAUDIO_LEFT

指定左側音訊通道。

MCI_DGV_SETAUDIO_RIGHT

指定正確的音訊通道。

MCI_DGV_SETAUDIO_STEREO

指定身歷聲。

MCI_DGV_STATUS_AUDIO_STREAM

dwReturn成員會傳回目前的音訊資料流程號碼。

MCI_DGV_STATUS_AVGBYTESPERSEC

dwReturn成員會傳回用於錄製的平均每秒位元組數。

MCI_DGV_STATUS_BASS

dwReturn成員會傳回目前的音訊基底層級。 使用此旗標MCI_DGV_STATUS_NOMINAL以取得名義層級。

MCI_DGV_STATUS_BITSPERPEL

dwReturn成員會傳回每圖元用來儲存擷取或記錄資料的位數。

MCI_DGV_STATUS_BITSPERSAMPLE

dwReturn成員會傳回裝置用於錄製的每個範例位數。 這只適用于支援 PCM 格式的裝置。

MCI_DGV_STATUS_BLOCKALIGN

dwReturn成員會傳回相對於輸入電壓開始的資料區塊對齊方式。

MCI_DGV_STATUS_BRIGHTNESS

dwReturn成員會傳回目前的視訊亮度等級。 使用此旗標MCI_DGV_STATUS_NOMINAL以取得名義層級。

MCI_DGV_STATUS_COLOR

dwReturn成員會傳回目前的色彩層級。 使用此旗標MCI_DGV_STATUS_NOMINAL以取得名義層級。

MCI_DGV_STATUS_CONTRAST

dwReturn成員會傳回目前的對比層級。 使用此旗標MCI_DGV_STATUS_NOMINAL以取得名義層級。

MCI_DGV_STATUS_FILEFORMAT

dwReturn成員會傳回錄製或儲存的目前檔案格式。

MCI_DGV_STATUS_FILE_MODE

dwReturn成員會傳回檔案作業的狀態：

MCI_DGV_FILE_MODE_EDITING

在剪下、複製、刪除、貼上和復原作業期間傳回。

MCI_DGV_FILE_MODE_IDLE

當檔案準備好進行下一個作業時傳回。

MCI_DGV_FILE_MODE_LOADING

載入檔案時傳回。

MCI_DGV_FILE_MODE_SAVING

儲存檔案時傳回。

MCI_DGV_STATUS_FILE_COMPLETION

dwReturn成員會傳回負載、儲存、擷取、剪下、複製、刪除、貼上或復原作業的估計百分比。 (應用程式可以使用此功能來提供進度的視覺指標。) 所有數位視訊裝置都不支援此旗標。

MCI_DGV_STATUS_FORWARD

如果裝置方向正向或裝置未播放， dwReturn 成員會傳回 TRUE 。

MCI_DGV_STATUS_FRAME_RATE

dwReturn成員必須與MCI_DGV_STATUS_NOMINAL、MCI_DGV_STATUS_RECORD或兩者搭配使用。 搭配MCI_DGV_STATUS_RECORD使用時，會傳回用於錄製的目前畫面播放速率。 當與MCI_DGV_STATUS_RECORD和MCI_DGV_STATUS_NOMINAL搭配使用時，會傳回與輸入視訊訊號相關聯的名義畫面播放速率。 與MCI_DGV_STATUS_NOMINAL搭配使用時，會傳回與檔案相關聯的名義畫面播放速率。 在所有情況下，單位都是每秒的畫面數乘以 1000。

MCI_DGV_STATUS_GAMMA

dwReturn成員會傳回目前的 gamma 值。 使用此旗標MCI_DGV_STATUS_NOMINAL以取得名義層級。

MCI_DGV_STATUS_HPAL

dwReturn成員會傳回目前調色盤控制碼的 ASCII 十進位值。 控制碼包含在傳回值的低序字中。

MCI_DGV_STATUS_HWND

dwReturn成員會傳回與這個設備磁碟機實例相關聯之目前明確或預設視窗控制碼的 ASCII 十進位值。 控制碼包含在傳回值的低序字中。

MCI_DGV_STATUS_KEY_COLOR

dwReturn成員會傳回目前的索引鍵色彩值。

MCI_DGV_STATUS_KEY_INDEX

dwReturn成員會傳回目前的索引鍵索引值。

MCI_DGV_STATUS_MONITOR

dwReturn成員會傳回常數，指出目前簡報的來源。 已定義下列常數：

MCI_DGV_MONITOR_FILE

檔案是來源。

MCI_DGV_MONITOR_INPUT

輸入是來源。

MCI_DGV_STATUS_MONITOR_METHOD

dwReturn成員會傳回常數，指出用於輸入監視的方法。 已定義下列常數：

MCI_DGV_METHOD_DIRECT

直接輸入監視。

MCI_DGV_METHOD_POST

輸入後監視。

MCI_DGV_METHOD_PRE

預先輸入監視。

MCI_DGV_STATUS_PAUSE_MODE

dwReturn成員會傳回MCI_MODE_PLAY如果裝置在播放時暫停，並在錄製時暫停裝置時傳回MCI_MODE_RECORD。 如果裝置未暫停，此命令會以錯誤傳回MCIERR_NONAPPLICABLE_FUNCTION。

MCI_DGV_STATUS_SAMPLESPERSECOND

dwReturn成員會傳回每秒記錄的樣本數目。

MCI_DGV_STATUS_SEEK_EXACTLY

dwReturn成員會傳回TRUE或FALSE，指出是否已設定搜尋的確切格式。 (應用程式可以使用 MCI_SET 命令搭配 MCI_DGV_SET_SEEK_EXACTLY flag.) 來設定此格式

MCI_DGV_STATUS_SHARPNESS

dwReturn成員會傳回目前的尖角等級。 使用此旗標MCI_DGV_STATUS_NOMINAL以取得名義層級。

MCI_DGV_STATUS_SIZE

dwReturn成員會傳回保留工作區將保留之壓縮資料的大約播放持續時間。 持續時間單位為目前時間格式。 如果沒有保留的磁碟空間，則會傳回零。 傳回的大小是近似的，因為壓縮資料的精確磁碟空間通常無法預測到資料壓縮之後。

MCI_DGV_STATUS_SMPTE

dwReturn成員會傳回與工作區中目前位置相關聯的 SMPTE 時間程式碼。

MCI_DGV_STATUS_SPEED

dwReturn成員會傳回目前的播放速度。

MCI_DGV_STATUS_STILL_FILEFORMAT

dwReturn成員會傳回MCI_CAPTURE命令目前的檔案格式。

MCI_DGV_STATUS_TINT

dwReturn成員會傳回目前的視訊色調層級。 使用此旗標MCI_DGV_STATUS_NOMINAL以取得名義層級。

MCI_DGV_STATUS_TREBLE

dwReturn成員會傳回目前的音訊音音層級。 使用此旗標MCI_DGV_STATUS_NOMINAL以取得名義層級。

MCI_DGV_STATUS_UNSAVED

dwReturn成員會傳回TRUE，如果工作區中有記錄的資料可能會因為MCI_CLOSE、MCI_LOAD、MCI_RECORD、MCI_RESERVE、MCI_CUT、MCI_DELETE或MCI_PASTE命令而遺失。 否則，成員會傳回 FALSE 。

MCI_DGV_STATUS_VIDEO

如果已啟用視訊， 則 dwReturn 成員會傳回MCI_ON，如果已停用，則會傳回MCI_OFF。

MCI_DGV_STATUS_VIDEO_RECORD

dwReturn成員會傳回MCI_ON或MCI_OFF，反映MCI_SETVIDEO命令MCI_DGV_SETVIDEO_RECORD旗標所設定的狀態。

MCI_DGV_STATUS_VIDEO_SOURCE

dwReturn成員會傳回常數，指出MCI_SETVIDEO命令的MCI_DGV_SETVIDEO_SOURCE旗標所設定的視訊來源類型。

MCI_DGV_STATUS_VIDEO_SRC_NUM

dwReturn成員會傳回目前使用中視訊輸入來源類型內的數位。

MCI_DGV_STATUS_VIDEO_STREAM

dwReturn成員會傳回目前的視訊資料流程編號。

MCI_DGV_STATUS_VOLUME

dwReturn成員會將音量的平均值傳回至左右喇叭。 使用此旗標MCI_DGV_STATUS_NOMINAL以取得名義層級。

MCI_DGV_STATUS_WINDOW_VISIBLE

如果視窗未隱藏， dwReturn 成員會傳回 TRUE 。

MCI_DGV_STATUS_WINDOW_MINIMIZED

如果視窗最小化， dwReturn 成員會傳回 TRUE 。

MCI_DGV_STATUS_WINDOW_MAXIMIZED

如果視窗最大化， dwReturn 成員會傳回 TRUE 。

MCI_STATUS_MEDIA_PRESENT

dwReturn成員會傳回TRUE。

對於數位視訊裝置， lpStatus 參數會指向 MCI_DGV_STATUS_PARMS 結構。

下列其他旗標會與 Sequencer 裝置類型搭配使用。 當為dwFlags參數指定MCI_STATUS_ITEM時，這些常數會用於lpStatus參數所指向結構的dwItem成員中。

MCI_SEQ_STATUS_DIVTYPE

dwReturn成員會設定為下列其中一個值，指出序列目前的除法類型：

  • MCI_SEQ_DIV_PPQN
  • MCI_SEQ_DIV_SMPTE_24
  • MCI_SEQ_DIV_SMPTE_25
  • MCI_SEQ_DIV_SMPTE_30
  • MCI_SEQ_DIV_SMPTE_30DROP

MCI_SEQ_STATUS_MASTER

dwReturn成員會設定為用於主要作業的同步處理類型。

MCI_SEQ_STATUS_OFFSET

dwReturn成員會設定為序列目前的 SMPTE 位移。

MCI_SEQ_STATUS_PORT

dwReturn成員會設定為序列所使用目前埠的 MIDI 裝置識別碼。

MCI_SEQ_STATUS_SLAVE

dwReturn成員會設定為用於次級作業的同步處理類型。

MCI_SEQ_STATUS_TEMPO

dwReturn成員會設定為 PPQN 檔案的目前 MIDI 序列暫存，或 SMPTE 檔案每秒的畫面格數。

MCI_STATUS_MEDIA_PRESENT

如果媒體插入裝置中， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

下列其他旗標會與 vcr 裝置類型搭配使用。 當為dwFlags參數指定MCI_STATUS_ITEM時，這些常數會用於lpStatus參數所指向結構的dwItem成員中。

MCI_STATUS_MEDIA_PRESENT

如果媒體插入裝置中， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

MCI_VCR_STATUS_ASSEMBLE_RECORD

如果元件模式開啟， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

MCI_VCR_STATUS_AUDIO_MONITOR

dwReturn成員會設定為常數，表示目前選取的音訊監視器類型。

MCI_VCR_STATUS_AUDIO_MONITOR_NUMBER

dwReturn成員會設定為目前選取的音訊監視器類型數目。

MCI_VCR_STATUS_AUDIO_RECORD

如果指定下一筆記錄命令時，將會錄製音訊， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。 如果您在此命令的 dwFlags 參數中指定MCI_TRACK， dwTrack 會包含此查詢適用的追蹤。

MCI_VCR_STATUS_AUDIO_SOURCE

dwReturn成員會設定為常數，表示目前的音訊來源類型。

MCI_VCR_STATUS_AUDIO_SOURCE_NUMBER

dwReturn成員會設定為目前選取的音訊來源類型數目。

MCI_VCR_STATUS_CLOCK

dwReturn成員會設定為目前的時鐘值，以總時鐘增量為單位。

MCI_VCR_STATUS_CLOCK_ID

dwReturn成員會設定為可唯一描述使用中時鐘的數位。

MCI_VCR_STATUS_COUNTER_FORMAT

dwReturn成員會設定為描述目前計數器格式的常數。 如需詳細資訊，請參閱 MCI_SET 命令的 MCI_SET_TIME_FORMAT 旗標。

MCI_VCR_STATUS_COUNTER_RESOLUTION

dwReturn成員會設定為描述計數器解析的常數，而且是下列其中一個值：

  • MCI_VCR_COUNTER_RES_FRAMES：計數器具有畫面的解析度。
  • MCI_VCR_COUNTER_RES_SECONDS：計數器的解析度為秒數。
  • MCI_VCR_STATUS_COUNTER_VALUE： dwReturn 成員會以目前的計數器時間格式設定為目前的計數器讀取。

MCI_VCR_STATUS_FRAME_RATE

dwReturn成員會設定為裝置目前的原生畫面播放速率。

MCI_VCR_STATUS_INDEX

dwReturn成員會設定為常數，描述螢幕上顯示目前的內容，而且是下列其中一項：

  • MCI_VCR_INDEX_COUNTER
  • MCI_VCR_INDEX_DATE
  • MCI_VCR_INDEX_TIME
  • MCI_VCR_INDEX_TIMECODE

MCI_VCR_STATUS_INDEX_ON

如果螢幕顯示開啟， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

MCI_VCR_STATUS_MEDIA_TYPE

dwReturn成員會設定為下列其中一項：

  • MCI_VCR_MEDIA_8MM
  • MCI_VCR_MEDIA_HI8
  • MCI_VCR_MEDIA_VHS
  • MCI_VCR_MEDIA_SVHS
  • MCI_VCR_MEDIA_BETA
  • MCI_VCR_MEDIA_EDBETA
  • MCI_VCR_MEDIA_OTHER

MCI_VCR_STATUS_NUMBER

當您將此旗標與 MCI_VCR_STATUS_TUNER_CHANNEL 旗標搭配使用時， dwNumber 成員會設定為邏輯微調器編號。

MCI_VCR_STATUS_NUMBER_OF_AUDIO_TRACKS

dwReturn成員會設定為可獨立選取的音訊播放軌數目。

MCI_VCR_STATUS_NUMBER_OF_VIDEO_TRACKS

dwReturn成員會設定為可獨立選取的視訊播放軌數目。

MCI_VCR_STATUS_PAUSE_TIMEOUT

dwReturn成員會設定為暫停命令的最大持續時間，以毫秒為單位。 零的傳回值表示不會發生逾時。

MCI_VCR_STATUS_PLAY_FORMAT

dwReturn成員會設定為下列其中一項：

  • MCI_VCR_FORMAT_EP
  • MCI_VCR_FORMAT_LP
  • MCI_VCR_FORMAT_OTHER
  • MCI_VCR_FORMAT_SP

MCI_VCR_STATUS_POSTROLL_DURATION

dwReturn成員會設定為視訊圖的長度，以目前時間格式在停止的位置之後播放。 這需要從停止或暫停命令停止 VCR 磁帶傳輸。

MCI_VCR_STATUS_POWER_ON

如果電源開啟， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

MCI_VCR_STATUS_PREROLL_DURATION

dwReturn成員會設定為視訊圖的長度，以目前時間格式在開始的點之前播放。 這是穩定 VCR 輸出的必要專案。

MCI_VCR_STATUS_RECORD_FORMAT

dwReturn成員會設定為下列其中一項：

  • MCI_VCR_FORMAT_EP
  • MCI_VCR_FORMAT_LP
  • MCI_VCR_FORMAT_OTHER
  • MCI_VCR_FORMAT_SP

MCI_VCR_STATUS_SPEED

dwReturn成員會設定為目前的速度。 如需詳細資訊，請參閱 MCI_SET 命令的 MCI_VCR_SET_SPEED 旗標。

MCI_VCR_STATUS_TIME_MODE

dwReturn成員會設定為下列其中一項：

  • MCI_VCR_TIME_COUNTER
  • MCI_VCR_TIME_DETECT
  • MCI_VCR_TIME_TIMECODE

如需詳細資訊，請參閱 MCI_SET 命令的 MCI_VCR_SET_TIME_MODE 旗標。

MCI_VCR_STATUS_TIME_TYPE

dwReturn成員會設定為常數，描述目前使用中 (播放、記錄、搜尋等) ，而且是下列其中一項：

MCI_VCR_TIME_COUNTER

計數器正在使用中。

MCI_VCR_TIME_TIMECODE

Timecode 正在使用中。

MCI_VCR_STATUS_TIMECODE_PRESENT

如果 timecode 存在於內容中的目前位置， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

MCI_VCR_STATUS_TIMECODE_RECORD

如果指定下一個記錄命令時，系統會將 dwReturn 成員設定為 TRUE ;否則會設定為 FALSE 。

MCI_VCR_STATUS_TIMECODE_TYPE

dwReturn成員會設定為常數，描述裝置直接支援的時間碼類型，而且是下列其中一項：

  • MCI_VCR_TIMECODE_TYPE_NONE：此裝置不會使用 timecode。
  • MCI_VCR_TIMECODE_TYPE_OTHER：此裝置使用未指定的時間代碼。
  • MCI_VCR_TIMECODE_TYPE_SMPTE：此裝置使用 SMPTE 時間碼。
  • MCI_VCR_TIMECODE_TYPE_SMPTE_DROP：此裝置使用 SMPTE 卸載時間碼。

MCI_VCR_STATUS_TUNER_CHANNEL

dwReturn成員會設定為目前的通道號碼。 如果您在此命令的 dwFlags 參數中指定MCI_VCR_STATUS_NUMBER， dwNumber 會包含此命令適用的邏輯微調器編號。

MCI_VCR_STATUS_VIDEO_MONITOR

dwReturn成員會設定為常數，表示目前選取的視訊監視器類型。

MCI_VCR_STATUS_VIDEO_MONITOR_NUMBER

dwReturn成員會設定為目前選取的視訊監視器類型數目。

MCI_VCR_STATUS_VIDEO_RECORD

如果指定下一個錄製命令時，將會錄製視訊， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。 如果您在此命令的 dwFlags 參數中指定MCI_TRACK， dwTrack 會包含套用此查詢的追蹤。

MCI_VCR_STATUS_VIDEO_SOURCE

dwReturn成員會設定為常數，指出目前選取的視訊來源類型。

MCI_VCR_STATUS_VIDEO_SOURCE_NUMBER

dwReturn成員會設定為目前選取的視訊來源類型數目。

MCI_VCR_STATUS_WRITE_PROTECTED

如果媒體受到寫入保護， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

若為 VCR 裝置， lpStatus 參數會指向 MCI_VCR_STATUS_PARMS 結構。

使用 MCI_STATUS_LENGTH 旗標來判斷 VCR 裝置的媒體長度一律會傳回 2 小時，除非已使用 MCI_SET 命令明確變更長度。

下列其他旗標會與 重迭 裝置類型搭配使用。 當為dwFlags參數指定MCI_STATUS_ITEM時，這些常數會用於lpStatus參數所指向結構的dwItem成員中。

MCI_OVLY_STATUS_HWND

dwReturn成員會設定為與視訊重迭裝置相關聯的視窗控制碼。

MCI_OVLY_STATUS_STRETCH

如果啟用延展功能， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

MCI_STATUS_MEDIA_PRESENT

如果媒體插入裝置， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

下列其他旗標會與 videodisc 裝置類型搭配使用。 當為dwFlags參數指定MCI_STATUS_ITEM時，這些常數會用於lpStatus參數所指向結構的dwItem成員中。

MCI_STATUS_MEDIA_PRESENT

如果媒體插入裝置， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

MCI_STATUS_MODE

dwReturn成員會設定為裝置的目前模式。 Videodisc 裝置除了可傳回 MCI_VD_MODE_PARK常數之外，除了常數之外，任何裝置都可以傳回的常數，如 dwFlags 參數所述。

MCI_VD_STATUS_DISC_SIZE

dwReturn成員會設定為以英吋 (8 或 12 英吋) 載入的磁片大小。

MCI_VD_STATUS_FORWARD

如果向前播放， dwReturn 成員會設定為 TRUE ;否則會設定為 FALSE 。

MCI videodisc 裝置不支援此旗標。

MCI_VD_STATUS_MEDIA_TYPE

dwReturn成員會設定為插入媒體的媒體類型。 可以傳回下列媒體類型：

MCI_VD_MEDIA_CAV

MCI_VD_MEDIA_CLV

MCI_VD_MEDIA_OTHER

MCI_VD_STATUS_SIDE

dwReturn成員會設定為 1 或 2，以指出載入磁片的哪一端。 並非所有 videodisc 裝置都支援此旗標。

MCI_VD_STATUS_SPEED

dwReturn成員會設定為每秒畫面格中的播放速度。 MCIPIONR。DRV 裝置驅動程式會傳回MCIERR_UNSUPPORTED_FUNCTION。

下列其他旗標會與 waveaudio 裝置類型搭配使用。 當為dwFlags參數指定MCI_STATUS_ITEM時，這些常數會用於lpStatus參數所指向結構的dwItem成員中。

MCI_WAVE_FORMATTAG

dwReturn成員會設定為用於播放、錄製和儲存的目前格式標籤。

MCI_WAVE_INPUT

dwReturn成員會設定為用於錄製的波浪輸入裝置。 如果未使用任何裝置且未明確設定任何裝置，則傳回錯誤會MCIERR_WAVE_INPUTUNSPECIFIED。

MCI_WAVE_OUTPUT

dwReturn成員會設定為用於播放的波浪輸出裝置。 如果沒有裝置正在使用中，且未明確設定任何裝置，則傳回錯誤會MCIERR_WAVE_OUTPUTUNSPECIFIED。

MCI_WAVE_STATUS_AVGBYTESPERSEC

dwReturn成員會設定為每秒用來播放、錄製和儲存的目前位元組。

MCI_WAVE_STATUS_BITSPERSAMPLE

dwReturn成員會設定為用於播放、錄製及儲存 PCM 格式化資料的每個範例目前的位。

MCI_WAVE_STATUS_BLOCKALIGN

dwReturn成員會設定為用於播放、錄製和儲存的目前區塊對齊方式。

MCI_WAVE_STATUS_CHANNELS

dwReturn成員會設定為用於播放、錄製和儲存的目前頻道計數。

MCI_WAVE_STATUS_LEVEL

dwReturn成員會設定為 PCM 格式化資料的目前記錄或播放層級。 根據所使用的樣本大小，此值會以 8 或 16 位值的形式傳回。 右或單聲道層級會以低序字傳回。 左通道層級會以高序字傳回。

MCI_WAVE_STATUS_SAMPLESPERSEC

dwReturn成員會設定為每秒用於播放、錄製和儲存的目前範例。

規格需求

需求 值
最低支援的用戶端
 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限傳統型應用程式]
標頭
Mmsystem.h (包含 Windows.h)

另請參閱

Mci

MCI 命令

MCI_CUT

MCI_DELETE

MCI_PASTE

MCI_RESERVE

MCI_SET

玩

record

尋求