MCIWndCreateA 函式（vfw.h）

發行項
11/20/2024

MCIWndCreate 函式會註冊 MCIWnd 視窗類別，並建立 MCIWnd 視窗以使用 MCI 服務。 MCIWndCreate 也可以開啟 MCI 裝置或檔案（例如 AVI 檔案），並將它與 MCIWnd 視窗產生關聯。

語法

HWND VFWAPIV MCIWndCreateA(
  HWND      hwndParent,
  HINSTANCE hInstance,
  DWORD     dwStyle,
  LPCSTR    szFile
);

參數

hwndParent

父視窗的句柄。

hInstance

要與MCIWnd視窗產生關聯的模組實例句柄。

dwStyle

定義視窗樣式的旗標。除了指定與 CreateWindowEx 函式搭配使用的視窗樣式之外，您還可以指定要搭配 MCIWnd 視窗使用的下列樣式。

價值	意義
MCIWNDF_NOAUTOSIZEWINDOW	當影像大小變更時，不會變更MCIWnd視窗的維度。
MCIWNDF_NOAUTOSIZEMOVIE	當 MCIWnd 視窗大小變更時，將不會變更目的地矩形的維度。
MCIWNDF_NOERRORDLG	禁止向用戶顯示MCI錯誤。
MCIWNDF_NOMENU	隱藏工具列上的 [功能表] 按鈕，並禁止使用者存取其彈出視窗。
MCIWNDF_NOOPEN	從 MCIWnd 功能表隱藏開啟和關閉命令，並禁止使用者在彈出視窗中存取這些選項。
MCIWNDF_NOPLAYBAR	從檢視隱藏工具列，並禁止使用者存取工具列。
MCIWNDF_NOTIFYANSI	在通知裝置模式變更的父視窗時，會導致 MCIWnd 使用 ANSI 字串，而不是 Unicode 字串。這個旗標會與MCIWNDF_NOTIFYMODE搭配使用。
MCIWNDF_NOTIFYMODE	每當裝置變更作業模式時，會導致 MCIWnd 以 MCIWNDM_NOTIFYMODE 訊息通知父視窗。此訊息的 lParam 參數會識別新的模式，例如MCI_MODE_STOP。
MCIWNDF_NOTIFYPOS	每當內容內播放或記錄位置發生變更時，MCIWnd 就會使用 MCIWNDM_NOTIFYPOS 訊息通知父視窗。此訊息的 lParam 參數包含內容中的新位置。
MCIWNDF_NOTIFYMEDIA	每當使用新裝置或開啟或關閉資料檔時，MCIWnd 就會使用 MCIWNDM_NOTIFYMEDIA 訊息通知父視窗。此訊息的 lParam 參數包含新檔名的指標。
MCIWNDF_NOTIFYSIZE	當 MCIWnd 視窗大小變更時，會導致 MCIWnd 通知父視窗。
MCIWNDF_NOTIFYERROR	導致MCIWnd在發生MCI錯誤時通知父視窗。
MCIWNDF_NOTIFYALL	導致使用所有 MCIWNDF 視窗通知樣式。
MCIWNDF_RECORD	將 [記錄] 按鈕新增至工具列，並在 MCI 裝置具有錄製功能時，將新的檔案命令新增至功能表。
MCIWNDF_SHOWALL	導致使用所有MCIWNDF_SHOW樣式。
MCIWNDF_SHOWMODE	在視窗標題列中顯示MCI裝置的目前模式。如需裝置模式的清單，請參閱 MCIWndGetMode 巨集。
MCIWNDF_SHOWNAME	在 MCIWnd 視窗標題列中顯示開啟的 MCI 裝置或資料檔案名稱。
MCIWNDF_SHOWPOS	在視窗標題列中顯示MCI裝置內容中的目前位置。

szFile

Null 終止字串，指出要開啟之 MCI 裝置或數據檔的名稱。

傳回值

如果成功或零，則傳回MCI視窗的句柄。

言論

子視窗的默認視窗樣式為WS_CHILD、WS_BORDER和WS_VISIBLE。當指定父視窗的非NULL 句柄時，MCIWndCreate 會假設子視窗。

父視窗的預設視窗樣式為WS_OVERLAPPEDWINDOW和WS_VISIBLE。當指定父視窗 NULL 句柄時，MCIWndCreate 會假設父視窗。

針對MCIWnd 巨集中的視窗句柄，使用此函式傳回的視窗句柄。如果您的應用程式使用此函式，則不需要使用 MCIWndRegisterClass 函式。

注意

vfw.h 標頭會根據 UNICODE 預處理器常數的定義，將 MCIWndCreate 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	vfw.h
連結庫	Vfw32.lib
DLL	Msvfw32.dll