PVIDEO_HW_START_IO fungsi panggilan balik (video.h)

Artikel
02/26/2024

HwVidStartIO memproses VRP yang ditentukan.

Sintaks

PVIDEO_HW_START_IO PvideoHwStartIo;

BOOLEAN PvideoHwStartIo(
  PVOID HwDeviceExtension,
  PVIDEO_REQUEST_PACKET RequestPacket
)
{...}

Parameter

HwDeviceExtension

Arahkan ke area penyimpanan per adaptor driver miniport. Untuk informasi selengkapnya, lihat Ekstensi Perangkat.

RequestPacket

Pointer ke struktur VIDEO_REQUEST_PACKET , yang berisi semua parameter yang awalnya diteruskan ke EngDeviceIoControl.

Nilai kembali

HwVidStartIO harus mengembalikan TRUE, yang menunjukkan bahwa HwVidStartIO telah menyelesaikan permintaan.

Keterangan

Setiap driver miniport video harus memiliki fungsi HwVidStartIO .

Driver port video memanggil HwVidStartIO sebagai respons terhadap setiap permintaan GDI EngDeviceIoControl , yang berasal dari driver tampilan yang sesuai. Ketika HwVidStartIO dipanggil, driver miniport memiliki paket permintaan video input sampai menyelesaikan operasi yang diminta. HwVidStartIO harus melakukan hal berikut:

Lihat anggota IoControlCodeVRP untuk menentukan operasi yang diminta oleh driver tampilan.
Periksa apakah VRP InputBufferLength dan/atau OutputBufferLength menunjukkan buffer yang cukup besar untuk memenuhi permintaan. Driver miniport harus mengembalikan kesalahan jika salah satu buffer terlalu kecil.
Memenuhi permintaan.
Atur anggota Status dan Informasi di VRP dan kembalikan TRUE.

Driver port video sistem menserialisasikan semua permintaan. Driver miniport tidak perlu melakukan serialisasi sendiri kecuali memiliki fungsi HwVidInterrupt .

Namun, setiap fungsi HwVidStartIO driver miniport harus menyelesaikan setiap operasi yang diminta atau mengatur kesalahan yang sesuai dalam StatusBlock VRP sebelum mengembalikan kontrol.

HwVidStartIO harus dibuat dapat diperbaharui.