DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi pfnAcquireNextDescriptorInfo mengembalikan deskriptor berikutnya dalam set deskriptor monitor, mengingat deskriptor saat ini.

Sintaks

DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirenextdescriptorinfo;

NTSTATUS DxgkddiMonitordescriptorsetAcquirenextdescriptorinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_DESCRIPTOR_CONST pMonitorDescriptorInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppNextMonitorDescriptorInfo
)
{...}

Parameter

[in] hMonitorDescriptorSet

Handel ke objek set deskriptor monitor. Driver miniport tampilan sebelumnya memperoleh handel ini dengan memanggil fungsi pfnGetMonitorDescriptorSet dari antarmuka Monitor.

[in] pMonitorDescriptorInfo

Penunjuk ke struktur D3DKMDT_MONITOR_DESCRIPTOR yang merupakan deskriptor saat ini. Driver miniport tampilan sebelumnya mendapatkan pointer ini dengan memanggil pfnAcquireFirstDescriptorInfo atau pfnAcquireNextDescriptorInfo.

[out] ppNextMonitorDescriptorInfo

Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_MONITOR_DESCRIPTOR . Struktur adalah deskriptor berikutnya dalam set.

Menampilkan nilai

Fungsi pfnAcquireNextDescriptorInfo mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil mengembalikan deskriptor berikutnya dalam set.
STATUS_GRAPHICS_NO_MORE_ELEMENTS_IN_DATASET	Fungsi berhasil, tetapi tidak ada lagi deskriptor dalam set.
STATUS_INVALID_PARAMETER	Parameter yang tidak valid disediakan.
STATUS_INVALID_MONITOR_DESCRIPTOR	Deskriptor yang disediakan dalam pMonitorDescriptorInfo tidak valid.
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET	Handel yang disediakan dalam hMonitorDescriptorSet tidak valid.

Keterangan

Setelah selesai menggunakan struktur D3DKMDT_MONITOR_DESCRIPTOR, Anda harus merilis struktur dengan memanggil pfnReleaseDescriptorInfo.

Anda dapat memperoleh semua deskriptor dalam deskriptor monitor yang ditetapkan dengan memanggil pfnAcquireFirstDescriptorInfo dan kemudian melakukan urutan panggilan ke pfnAcquireNextDescriptorInfo.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Target Platform	Desktop
Header	d3dkmddi.h (termasuk D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Bagikan melalui