Persimpangan Rentang Data di AVStream

Format data adalah satu set parameter yang menjelaskan beberapa aspek koneksi. Misalnya, format data audio mungkin menentukan format audio tertentu pada sampel X per detik dan bit Y per sampel.

Rentang data menentukan urutan parameter yang valid. Misalnya, rentang data audio dapat menentukan format audio tertentu pada sampel A-B per detik dan bit C-D per sampel.

Minidriver menyediakan daftar rentang data yang didukungnya untuk pin tertentu di anggota DataRanges dari struktur KSPIN_DESCRIPTOR yang sesuai.

Di AVStream, minidriver dapat menyediakan penangan interseksi rentang data mereka sendiri dengan menyediakan pointer ke rutin panggilan balik yang disediakan oleh minidriver di anggota IntersectHandler dari KSPIN_DESCRIPTOR_EX. Untuk membiarkan AVStream memotong rentang, atur anggota ini ke NULL. Lihat AVStrMiniIntersectHandlerEx untuk mempelajari cara menentukan rutinitas panggilan balik.

Jika minidriver menyediakan pengendali perpotongan, ketika perpotongan perlu dilakukan, minidriver menerima dua rentang data yang sesuai dalam jenis utama, subformat, dan penentu. Selain itu, atribut yang diperlukan dari rentang data cocok.

Jika rentang beririsan dan ruang buffer yang memadai disediakan dalam parameter Data dari rutinitas panggilan balik AVStrMiniIntersectHandlerEx, rutinitas perpotongan memilih format di perpotongan dan mengembalikannya ke pemanggil dalam buffer yang ditunjukkan oleh Data.

Jika dua rentang data tidak bersinggungan, handler mengembalikan STATUS_NO_MATCH.

Jika minidriver telah menentukan pengiriman AVStrMiniPinSetDataFormat , maka AVStream memanggil pengiriman ini untuk memberi tahu minidriver bahwa AVStream mengatur format tertentu pada pin. Berikan penunjuk ke rutinitas panggilan balik AVStrMiniPinSetDataFormat Anda di anggota SetDataFormat dari struktur KSPIN_DISPATCH. (Minidriver yang merupakan klien kelas stream menerima SRB_SET_DATA_FORMAT alih-alih AVStrMiniPinSetDataFormat.)

Minidriver dapat menolak format yang diusulkan dengan mengembalikan STATUS_NO_MATCH dari AVStrMiniPinSetDataFormat.

Selain panggilan awal ke AVStrMiniPinSetDataFormat sebelum pin dibuat, minidriver Anda dapat menerima panggilan AVStrMiniPinSetDataFormat kedua tepat sebelum pin beralih ke status RUN. Jika klien AVStream atau kelas stream Anda adalah minidriver penangkap video dan Anda menerima pemberitahuan seperti itu, pengiriman ini berisi parameter permukaan yang sebenarnya. Jika memungkinkan, minidriver seharusnya tidak gagal dalam perubahan format kedua ini. Jangan berasumsi bahwa panggilan pengiriman kedua akan terjadi.

Minidriver harus mengambil data dalam format apa pun yang terkandung dalam pengiriman AVStrMiniPinSetDataFormat yang berhasil terakhir.