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 [僅限傳統型應用程式]
標頭
Mmsystem.h (包含 Windows.h)

另請參閱

Mci

MCI 命令