DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO fungsi panggilan balik (d3dkmddi.h)

  • Artikel

Fungsi pfnAcquireFirstDescriptorInfo mengembalikan deskriptor pertama dalam objek set deskriptor monitor.

Sintaks

DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo;

NTSTATUS DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppFirstMonitorDescriptorInfo
)
{...}

Parameter

[in] hMonitorDescriptorSet

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

[out] ppFirstMonitorDescriptorInfo

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

Menampilkan nilai

Fungsi pfnAcquireFirstDescriptorInfo mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
STATUS_SUCCESS Fungsi berhasil mengembalikan deskriptor pertama dalam set.
STATUS_GRAPHICS_DATASET_IS_EMPTY Fungsi berhasil, tetapi tidak ada deskriptor dalam set.
STATUS_INVALID_PARAMETER Parameter yang tidak valid disediakan.
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