PVIDEO_HW_POWER_GET fungsi panggilan balik (video.h)

  • Artikel

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)

Lihat juga

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT