Fungsi VideoPortQueryServices (video.h)

Artikel
08/08/2023

Fungsi VideoPortQueryServices mengekspos antarmuka tertentu yang diimplementasikan oleh driver port video.

Sintaks

VIDEOPORT_API VP_STATUS VideoPortQueryServices(
  [in]      IN PVOID               HwDeviceExtension,
  [in]      IN VIDEO_PORT_SERVICES ServicesType,
  [in, out] IN OUT PINTERFACE      Interface
);

Parameter

[in] HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

[in] ServicesType

Nilai dari jenis enumerasi VIDEO_PORT_SERVICES yang menentukan antarmuka mana yang diminta.

[in, out] Interface

Penunjuk ke struktur INTERFACE , yang berisi informasi dasar tentang antarmuka yang diminta. Lihat bagian Keterangan berikut untuk informasi selengkapnya.

Nilai kembali

Jika VideoPortQueryServices berhasil, video akan mengembalikan NO_ERROR; jika tidak, kode kesalahan akan dikembalikan.

Keterangan

Jika parameter ServicesType diatur ke VideoPortServicesI2C, parameter Antarmuka harus menjadi penunjuk ke struktur VIDEO_PORT_I2C_INTERFACE , transmisikan sebagai penunjuk ke struktur ANTARMUKA.

Demikian pula, jika parameter ServicesType diatur ke VideoPortServicesAGP, parameter Antarmuka harus menjadi penunjuk ke struktur VIDEO_PORT_AGP_INTERFACE , atau struktur VIDEO_PORT_AGP_INTERFACE_2 , masing-masing dilemparkan sebagai penunjuk ke struktur INTERFACE .

Struktur VIDEO_PORT_AGP_INTERFACE dan VIDEO_PORT_AGP_INTERFACE_2 hampir identik, kecuali bahwa struktur terakhir memiliki anggota yang menunjuk ke fungsi AgpSetRate , yang digunakan untuk mengatur ulang tingkat transfer untuk chipset AGP. Driver miniport video yang meminta dukungan AGP harus memanggil VideoPortQueryServices terlebih dahulu dengan Antarmuka yang menunjuk ke struktur VIDEO_PORT_AGP_INTERFACE_2. Jika panggilan tersebut gagal, driver miniport kemudian dapat melakukan panggilan lain ke VideoPortQueryServices, kali ini dengan Antarmuka menunjuk ke struktur VIDEO_PORT_AGP_INTERFACE.

Jika parameter ServicesType diatur ke VideoPortServicesInt10, parameter Antarmuka harus menjadi penunjuk ke struktur VIDEO_PORT_INT10_INTERFACE , ditransmisikan sebagai penunjuk ke struktur ANTARMUKA.

Jika parameter ServicesType diatur ke VideoPortServicesDebugReport, parameter Antarmuka harus menjadi penunjuk ke struktur VIDEO_PORT_DEBUG_REPORT_INTERFACE , ditransmisikan sebagai penunjuk ke struktur ANTARMUKA.

Jika parameter ServicesType diatur ke VideoPortServicesWCMemoryProtection, parameter Antarmuka harus menjadi penunjuk ke struktur VIDEO_PORT_WCMEMORYPROTECTION_INTERFACE , transmisikan sebagai penunjuk ke struktur ANTARMUKA.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows XP dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	video.h (sertakan Video.h)
Pustaka	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL