Fungsi MCIWndCreateA (vfw.h)

Artikel
11/20/2024

Fungsi MCIWndCreate mendaftarkan kelas jendela MCIWnd dan membuat jendela MCIWnd untuk menggunakan layanan MCI. MCIWndCreate juga dapat membuka perangkat atau file MCI (seperti file AVI) dan mengaitkannya dengan jendela MCIWnd.

Sintaksis

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

Parameter

hwndParent

Tangani ke jendela induk.

hInstance

Tangani ke instans modul untuk dikaitkan dengan jendela MCIWnd.

dwStyle

Bendera yang menentukan gaya jendela. Selain menentukan gaya jendela yang digunakan dengan fungsi CreateWindowEx, Anda dapat menentukan gaya berikut untuk digunakan dengan jendela MCIWnd.

Nilai	Arti
MCIWNDF_NOAUTOSIZEWINDOW	Tidak akan mengubah dimensi jendela MCIWnd saat ukuran gambar berubah.
MCIWNDF_NOAUTOSIZEMOVIE	Tidak akan mengubah dimensi persegi panjang tujuan saat ukuran jendela MCIWnd berubah.
MCIWNDF_NOERRORDLG	Menghambat tampilan kesalahan MCI kepada pengguna.
MCIWNDF_NOMENU	Menyembunyikan tombol Menu dari tampilan pada toolbar dan melarang pengguna mengakses menu pop-upnya.
MCIWNDF_NOOPEN	Menyembunyikan perintah buka dan tutup dari menu MCIWnd dan melarang pengguna mengakses pilihan ini di menu pop-up.
MCIWNDF_NOPLAYBAR	Menyembunyikan bilah alat dari tampilan dan melarang pengguna mengaksesnya.
MCIWNDF_NOTIFYANSI	Menyebabkan MCIWnd menggunakan string ANSI alih-alih string Unicode saat memberi tahu jendela induk perubahan mode perangkat. Bendera ini digunakan dalam kombinasi dengan MCIWNDF_NOTIFYMODE.
MCIWNDF_NOTIFYMODE	Menyebabkan MCIWnd memberi tahu jendela induk dengan pesan MCIWNDM_NOTIFYMODE setiap kali perangkat mengubah mode operasi. Parameter lParam dari pesan ini mengidentifikasi mode baru, seperti MCI_MODE_STOP.
MCIWNDF_NOTIFYPOS	Menyebabkan MCIWnd memberi tahu jendela induk dengan pesan MCIWNDM_NOTIFYPOS setiap kali perubahan posisi pemutaran atau rekaman dalam konten terjadi. Parameter lParam pesan ini berisi posisi baru dalam konten.
MCIWNDF_NOTIFYMEDIA	Menyebabkan MCIWnd memberi tahu jendela induk dengan pesan MCIWNDM_NOTIFYMEDIA setiap kali perangkat baru digunakan atau file data dibuka atau ditutup. Parameter lParam pesan ini berisi penunjuk ke nama file baru.
MCIWNDF_NOTIFYSIZE	Menyebabkan MCIWnd memberi tahu jendela induk ketika ukuran jendela MCIWnd berubah.
MCIWNDF_NOTIFYERROR	Menyebabkan MCIWnd memberi tahu jendela induk ketika terjadi kesalahan MCI.
MCIWNDF_NOTIFYALL	Menyebabkan semua gaya pemberitahuan jendela MCIWNDF digunakan.
MCIWNDF_RECORD	Menambahkan tombol Rekam ke toolbar dan menambahkan perintah file baru ke menu jika perangkat MCI memiliki kemampuan perekaman.
MCIWNDF_SHOWALL	Menyebabkan semua gaya MCIWNDF_SHOW digunakan.
MCIWNDF_SHOWMODE	Menampilkan mode perangkat MCI saat ini di bilah judul jendela. Untuk daftar mode perangkat, lihat makro MCIWndGetMode.
MCIWNDF_SHOWNAME	Menampilkan nama perangkat atau file data MCI yang terbuka di bilah judul jendela MCIWnd.
MCIWNDF_SHOWPOS	Menampilkan posisi saat ini dalam konten perangkat MCI di bilah judul jendela.

szFile

Untai (karakter) yang dihentikan null yang menunjukkan nama perangkat MCI atau file data untuk dibuka.

Mengembalikan nilai

Mengembalikan handel ke jendela MCI jika berhasil atau nol sebaliknya.

Komentar

Gaya jendela default untuk jendela anak WS_CHILD, WS_BORDER, dan WS_VISIBLE. MCIWndCreate mengasumsikan jendela anak ketika handel null non- jendela induk ditentukan.

Gaya jendela default untuk jendela induk WS_OVERLAPPEDWINDOW dan WS_VISIBLE. MCIWndCreate mengasumsikan jendela induk ketika handel NULL dari jendela induk ditentukan.

Gunakan handel jendela yang dikembalikan oleh fungsi ini untuk handel jendela di makro MCIWnd. Jika aplikasi Anda menggunakan fungsi ini, aplikasi tidak perlu menggunakan fungsi MCIWndRegisterClass.

Nota

Header vfw.h mendefinisikan MCIWndCreate sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	vfw.h
Pustaka	Vfw32.lib
DLL	Msvfw32.dll

Lihat juga

MCIWNDM_NOTIFYMEDIA

MCIWNDM_NOTIFYMODE

MCIWNDM_NOTIFYPOS

MCIWndGetMode

MCIWndRegisterClass

Bagikan melalui