PVIDEO_HW_POWER_GET fungsi panggilan balik (video.h)
Kueri HwVidGetPowerState apakah perangkat dapat mendukung status daya yang diminta.
Sintaks
PVIDEO_HW_POWER_GET PvideoHwPowerGet;
VP_STATUS PvideoHwPowerGet(
PVOID HwDeviceExtension,
ULONG HwId,
PVIDEO_POWER_MANAGEMENT VideoPowerControl
)
{...}
Parameter
HwDeviceExtension
Arahkan ke area penyimpanan per adaptor driver miniport. Untuk informasi selengkapnya, lihat Ekstensi Perangkat.
HwId
Pointer ke ID perangkat 32-bit yang secara unik mengidentifikasi perangkat yang harus dikueri driver miniport. Parameter ini dikembalikan oleh fungsi HwVidGetVideoChildDescriptor driver miniport. Atau, nilai DISPLAY_ADAPTER_HW_ID menunjukkan bahwa informasi daya sedang diminta dari adaptor itu sendiri.
VideoPowerControl
Penunjuk ke struktur VIDEO_POWER_MANAGEMENT yang menentukan status daya yang dukungannya sedang dikueri.
Nilai kembali
HwVidGetPowerState mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
NO_ERROR | Perangkat mendukung status daya yang diminta. |
ERROR_DEVICE_REINITIALIZATION_NEEDED | Driver gagal dalam kueri status daya. |
Keterangan
HwVidGetPowerState adalah fungsi yang diperlukan dalam driver miniport video.
Driver harus memeriksa ID yang ditentukan dalam HwId untuk menentukan perangkat mana yang akan dikueri. Driver kemudian harus menentukan apakah perangkat tersebut mendukung status daya yang ditentukan dalam anggota PowerState dari struktur VIDEO_POWER_MANAGEMENT tempat VideoPowerControl menunjuk .
Fungsi ini tidak boleh mengembalikan status daya perangkat saat ini.
HwVidGetPowerState harus dibuat dapat di-pageable.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | video.h (sertakan Video.h) |