open 命令

  • 發行項

開啟的命令會初始化裝置。 所有 MCI 裝置都會辨識此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("open %s %s %s"), 
  lpszDevice, 
  lpszOpenFlags, 
  lpszFlags
);

參數

lpszDevice

MCI 裝置或設備磁碟機的識別碼。 這可以是登錄中指定的裝置名稱 (，或SYSTEM.INI檔案) 或設備磁碟機的檔案名。 如果您指定設備磁碟機的檔案名，您可以選擇性地包含 。DRV 擴充功能，但您不應該包含檔案的路徑。

lpszOpenFlags

識別要初始化之物件的旗標。 下表列出可辨識 開啟 命令的裝置類型，以及每種類型所使用的旗標。

值 意義 意義
cdaudio 別名 device_alias可共用 類型 device_type
digitalvideo alias device_aliaselementnamenostatic parent hwndsharable 樣式子樣式重迭樣式快顯樣式 style_type類型 device_type
overlay alias device_alias父 hwnd可共用樣式子系 樣式重迭樣式快顯樣式 style_type類型 device_type
排序器 別名 device_alias 可共用 類型 device_type
錄影機 別名 device_alias可共用 類型 device_type
videodisk 別名 device_alias可共用 類型 device_type
waveaudio 別名 device_alias緩衝區 buffer_size 可共用類型 device_type

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

值 意義
別名 device_alias 指定指定裝置的替代名稱。 如果指定，則必須在後續命令中將它當做 device_id 。
elementname 指定裝置開啟時 (檔案) 載入的裝置專案名稱。
buffer buffer_size 設定電壓-音訊裝置所使用的緩衝區大小，以秒為單位。 安裝或設定電壓音訊裝置時，會設定緩衝區的預設大小。 緩衝區大小通常會設定為 4 秒。 使用 MCIWAVE 裝置時，大小下限為 2 秒，大小上限為 9 秒。
parent hwnd 指定父視窗的視窗控制碼。
共用 將裝置或檔案初始化為可共用。 除非您在原始和後續 開啟 命令中指定「可共用」，否則後續嘗試開啟裝置或檔案會失敗。 如果裝置已開啟且無法共用，MCI 會傳回不正確裝置錯誤。
MCISEQ Sequencer 和 MCIWAVE 裝置不支援共用檔案。
樣式子系 開啟具有子視窗樣式的視窗。
樣式重迭 開啟具有重迭視窗樣式的視窗。
樣式快顯 開啟具有快顯視窗樣式的視窗。
樣式 style_type 表示視窗樣式。
類型 device_type 指定檔案的裝置類型。

lpszFlags

可以是 「wait」、「notify」 或兩者。 如需這些旗標的詳細資訊，請參閱 等候、通知和測試旗標。

傳回值

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

備註

MCI 會保留 CD 音訊裝置類型的 「cdaudio」、videodisc 代表 videodisc 裝置類型、MIDI sequencer 裝置類型為 「sequencer」、數位視訊裝置類型的 「AVIVideo」 ，以及針對電壓音訊裝置類型保留 「waveaudio」。

除了 「type」 旗標，MCI 可以根據檔案所使用的副檔名來選取裝置，如SYSTEM.INI檔案的登錄或 [mci 副檔名] 區段中所記錄。

MCI 可以使用檔案介面指標或資料流程介面指標來開啟 AVI 檔案。 若要使用任一類型的介面指標開啟檔案，請指定 at 符號 (@) 後面接著介面指標取代 lpszDevice 參數的檔案或裝置名稱。 For more information about the file and stream interfaces, see " AVIFile Functions and Macros."

下列命令會開啟 「mysound」 裝置。

open new type waveaudio alias mysound buffer 6

使用裝置名稱 「new」，電壓驅動程式會準備新的電壓資源。 命令會指派裝置別名 「mysound」，並指定 6 秒的緩衝區。

如果您將裝置名稱與檔案名結合，則可以排除 「type」 旗標。 當您使用下列語法時，MCI 會辨識此組合：

device_name ！ element_name

驚嘆號會分隔裝置名稱與檔案名。 驚嘆號不應以空格分隔。

下列範例會開啟 RIGHT。使用 「waveaudio」 裝置的 WAV 檔案。

open waveaudio!right.wav

MCIWAVE 驅動程式需要非同步電壓音訊裝置。

規格需求

需求 值
最低支援的用戶端
 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限桌面應用程式]
標頭
Corecrt_io.h

另請參閱

Mci

MCI 命令字串