MCIWndCreateW 函式 (vfw.h)

發行項
03/03/2024

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

語法

HWND VFWAPIV MCIWndCreateW(
  HWND      hwndParent,
  HINSTANCE hInstance,
  DWORD     dwStyle,
  LPCWSTR   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 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	vfw.h
程式庫	Vfw32.lib
Dll	Msvfw32.dll