MCI_OPEN命令
MCI_OPEN命令會初始化裝置或檔案。 所有裝置都會辨識此命令。
若要傳送此命令,請使用下列參數呼叫 mciSendCommand 函式。
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_OPEN,
DWORD dwFlags,
(DWORD) (LPMCI_OPEN_PARMS) lpOpen
);
參數
-
wDeviceID
-
要接收命令訊息之 MCI 裝置的裝置識別碼。
-
dwFlags
-
MCI_NOTIFY或MCI_WAIT。 如需這些旗標的相關資訊,請參閱 Wait、Notify 和 Test Flags。
-
lpOpen
-
MCI_OPEN_PARMS結構的指標。 (具有擴充命令集的裝置,可能會以裝置特定的結構取代此結構。)
傳回值
如果成功或發生錯誤,則傳回零。
備註
每當 mciSendCommand 函式中指定裝置時,都必須使用MCI_OPEN_TYPE旗標。 如果您藉由指定裝置類型常數來開啟裝置,除了MCI_OPEN_TYPE之外,還必須指定MCI_OPEN_TYPE_ID旗標。 如需裝置類型常數的清單,請參閱 MCI 裝置類型。
如果一開始開啟裝置或檔案時未指定MCI_OPEN_SHAREABLE旗標,則裝置或檔案的所有後續MCI_OPEN命令都會失敗。 如果裝置或檔案已經開啟且未指定此旗標,即使第一個開啟的命令指定MCI_OPEN_SHAREABLE,呼叫仍會失敗。 針對 MCISEQ 開啟的檔案。DRV 和 MCIWAVE。DRV 裝置不可共用。
裝置名稱中會忽略大小寫,但不能有開頭或尾端的空白。
若要透過登錄) 中的專案使用自動類型選取 (,請將檔案名和副檔名指派給lpOpen所識別結構的lpstrElementName成員、將lpstrDeviceType成員設定為Null,並設定MCI_OPEN_ELEMENT旗標。
下列其他旗標適用于支援MCI_OPEN的所有裝置:
-
MCI_OPEN_ALIAS
-
別名包含在lpOpen所識別結構的lpstrAlias成員中。
-
MCI_OPEN_SHAREABLE
-
裝置或檔案應以可共用方式開啟。
-
MCI_OPEN_TYPE
-
裝置類型名稱或常數包含在lpOpen所識別結構的lpstrDeviceType成員中。
-
MCI_OPEN_TYPE_ID
-
lpOpen 所識別結構之lpstrDeviceType成員的低序字包含標準 MCI 裝置類型識別碼,而高序字選擇性地包含裝置的序數索引。 使用此旗標搭配 MCI_OPEN_TYPE 旗標。
下列其他旗標適用于複合裝置:
-
MCI_OPEN_ELEMENT
-
檔案名包含在lpOpen所識別結構的lpstrElementName成員中。
-
MCI_OPEN_ELEMENT_ID
-
lpOpen 所識別結構的lpstrElementName成員會解譯為DWORD值,而且在裝置內部具有意義。 使用此旗標搭配 MCI_OPEN_ELEMENT 旗標。
下列其他旗標會搭配 digitalvideo 裝置類型使用:
-
MCI_DGV_OPEN_NOSTATIC
-
裝置應該減少調色盤中靜態 (系統) 色彩的數目。 這會增加可供轉譯視訊資料流程的色彩數目。 此旗標僅適用于與 Windows 共用調色盤的裝置。
-
MCI_DGV_OPEN_PARENT
-
父視窗控制碼是在lpOpen所識別結構的hWndParent成員中指定。
-
MCI_DGV_OPEN_WS
-
視窗樣式是在lpOpen所識別結構的dwStyle成員中指定。
-
MCI_DGV_OPEN_16BIT
-
指出 16 位 MCI 裝置支援的喜好設定。
-
MCI_DGV_OPEN_32BIT
-
指出 32 位 MCI 裝置支援的喜好設定。
對於數位視訊裝置, lpOpen 參數會指向 MCI_DGV_OPEN_PARMS 結構。
下列其他旗標會與 重迭 裝置類型搭配使用:
-
MCI_OVLY_OPEN_PARENT
-
父視窗控制碼是在lpOpen所識別結構的hWndParent成員中指定。
-
MCI_OVLY_OPEN_WS
-
視窗樣式是在lpOpen所識別結構的dwStyle成員中指定。 dwStyle值會指定驅動程式建立的視窗樣式,並在應用程式未提供時顯示。 樣式參數會採用定義視窗樣式的整數。 這些常數與標準視窗樣式相同, (例如WS_CHILD、WS_OVERLAPPEDWINDOW或WS_POPUP) 。
若為視訊重迭裝置, lpOpen 參數會指向 MCI_OVLY_OPEN_PARMS 結構。
下列其他旗標會搭配 waveaudio 裝置類型使用:
-
MCI_WAVE_OPEN_BUFFER
-
緩衝區長度是在lpOpen所識別結構的dwBufferSeconds成員中指定。
對於電壓音訊裝置, lpOpen 參數會指向 MCI_WAVE_OPEN_PARMS 結構。 MCIWAVE 驅動程式需要非同步電壓音訊裝置。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
標頭 |
|