MCIWndCreateW 関数 (vfw.h)

[アーティクル]
08/27/2023

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 が Unicode 文字列ではなく ANSI 文字列を使用するようにします。このフラグは、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	MCI エラーが発生したときに、MCIWnd によって親ウィンドウに通知されます。
MCIWNDF_NOTIFYALL	すべての MCIWNDF ウィンドウ通知スタイルを使用します。
MCIWNDF_RECORD	MCI デバイスに記録機能がある場合は、ツールバーに [レコード] ボタンを追加し、メニューに新しいファイルコマンドを追加します。
MCIWNDF_SHOWALL	すべてのMCIWNDF_SHOWスタイルを使用します。
MCIWNDF_SHOWMODE	ウィンドウタイトルバーに MCI デバイスの現在のモードを表示します。デバイスモードの一覧については、 MCIWndGetMode マクロを参照してください。
MCIWNDF_SHOWNAME	開いている MCI デバイスまたはデータファイルの名前を MCIWnd ウィンドウのタイトルバーに表示します。
MCIWNDF_SHOWPOS	ウィンドウタイトルバーの MCI デバイスのコンテンツ内の現在の位置を表示します。

szFile

開く MCI デバイスまたはデータファイルの名前を示す Null で終わる文字列。

戻り値

成功した場合は MCI ウィンドウにハンドルを返し、それ以外の場合は 0 を返します。

注釈

子ウィンドウの既定のウィンドウスタイルは、WS_CHILD、WS_BORDER、WS_VISIBLEです。 MCIWndCreate は、親ウィンドウの NULL 以外のハンドルが指定されている場合に、子ウィンドウを想定します。

親ウィンドウの既定のウィンドウスタイルはWS_OVERLAPPEDWINDOWされ、WS_VISIBLEされます。 MCIWndCreate は、親ウィンドウの NULL ハンドルが指定されている場合に親ウィンドウを想定します。

MCIWnd マクロのウィンドウハンドルには、この関数によって返されるウィンドウハンドルを使用します。アプリケーションでこの関数を使用する場合、 MCIWndRegisterClass 関数を使用する必要はありません。

注意

vfw.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MCIWndCreate を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	vfw.h
Library	Vfw32.lib
[DLL]	Msvfw32.dll