kode kontrol DD_DXAPI_OPENVPCAPTUREDEVICE
Driver pengambilan video melewati DD_DXAPI_OPENVPCAPTUREDEVICE dalam parameter dwFunctionNum dari fungsi DxApi untuk membuka perangkat untuk pengambilan video.
Parameter Input
- lpvInBuffer
Pointer ke struktur DDOPENVPCAPTUREDEVICEIN yang berisi informasi objek VPE relevan yang diperlukan untuk pengambilan.
Parameter Output
- lpvOutBuffer
Pointer ke struktur DDOPENVPCAPTUREDEVICEOUT yang berisi handel tangkapan baru.
Keterangan
Perangkat penangkapan VPE memungkinkan data port video perangkat keras untuk secara otomatis dikuasai bus dari permukaan ke buffer tertentu. Membuka perangkat penangkapan menentukan garis mana yang akan diambil. Misalnya, untuk VBI, driver penangkapan mungkin hanya tertarik pada 21 baris pertama. Jika driver pengambilan ingin mengambil wilayah yang berbeda ke buffer yang berbeda (misalnya, VBI dan video untuk memisahkan buffer), beberapa perangkat pengambilan dapat dibuat.
Saat perangkat pengambilan dibuat, transportasi video mode kernel membuat antrean untuk setiap perangkat. Driver nantinya dapat menambahkan buffer ke antrean ini. Setiap kali port video perangkat keras V-sync terjadi, transportasi video mode kernel secara otomatis memulai master bus yang benar dari permukaan buffer bingkai yang terakhir diisi oleh port video perangkat keras ke buffer dalam antrean. Jika Anda tidak ingin mengambil di setiap bidang, Anda dapat menunjukkan hal ini dengan mengatur anggota dwCaptureEveryNFields dari DDOPENVPCAPTUREDEVICEIN ke sesuatu selain 1.
Anggota hDirectDraw dan hVideoPort DDOPENVPCAPTUREDEVICEIN menentukan objek DirectDraw dan objek VPE tempat Anda ingin mengambil. Anggota dwStartLine dan dwEndLine menunjukkan baris mana yang akan diambil. Anggota dwStartLine relatif terhadap awal permukaan (0 adalah baris pertama) dan dwEndLine bersifat inklusif (mengatur dwStartLine dan dwEndLine ke 0 menyebabkan baris pertama ditangkap).
Driver juga harus menentukan panggilan balik yang dipanggil ketika perangkat pengambilan menjadi tidak dapat digunakan karena objek VPE dirilis pada mode pengguna. Anggota pContext DDOPENVPCAPTUREDEVICEIN berisi nilai yang diteruskan jika fungsi panggilan balik pfnCaptureClose pernah dipanggil.
Jika anggota ddRVal DDOPENVPCAPTUREDEVICEOUT diatur ke DD_OK, output dari pengidentifikasi fungsi ini adalah handel tangkapan DirectDraw baru. Handel baru ini harus digunakan pada semua panggilan berikutnya yang mereferensikan perangkat penangkapan ini.
Pengidentifikasi fungsi ini hanya dapat dipanggil dari PASSIVE_LEVEL.
Persyaratan
File header: Ddkmapi.h (termasuk Ddkmapi.h)