DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET fungsi panggilan balik (d3dkmddi.h)

  • Artikel

Fungsi pfnAcquireMonitorSourceModeSet mengembalikan handel ke objek set mode sumber monitor yang terkait dengan monitor tertentu.

Sintaks

DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET DxgkddiMonitorAcquiremonitorsourcemodeset;

NTSTATUS DxgkddiMonitorAcquiremonitorsourcemodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORSOURCEMODESET phMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORSOURCEMODESET_INTERFACE ppMonitorSourceModeSetInterface
)
{...}

Parameter

[in] hAdapter

Handel yang mengidentifikasi adaptor tampilan. Subsistem kernel grafis Microsoft DirectX sebelumnya menyediakan handel ini ke driver miniport tampilan dalam parameter DxgkInterface dari fungsi DxgkDdiStartDevice .

[in] VideoPresentTargetId

Bilangan bulat yang mengidentifikasi salah satu video yang menyajikan target pada adaptor tampilan. Objek set mode sumber yang dikembalikan menjelaskan mode yang tersedia pada monitor yang tersambung ke target sajikan video ini.

[out] phMonitorSourceModeSet

Penunjuk ke variabel yang menerima handel ke objek set mode sumber monitor.

[out] ppMonitorSourceModeSetInterface

Penunjuk ke variabel yang menerima penunjuk ke struktur DXGK_MONITORSOURCEMODESET_INTERFACE . Struktur berisi pointer ke fungsi yang dapat dipanggil driver miniport tampilan untuk memeriksa dan mengubah objek set mode sumber monitor.

Menampilkan nilai

Fungsi pfnAcquireMonitorSourceModeSet mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
STATUS_SUCCESS Fungsi berhasil.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER Handel yang disediakan dalam hAdapter tidak valid.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET Pengidentifikasi yang disediakan dalam VideoPresentTargetId tidak valid.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED Tidak ada monitor yang terhubung ke target sajikan video yang diidentifikasi oleh VideoPresentTargetId.

Fungsi ini mungkin juga mengembalikan kode kesalahan lain yang ditentukan dalam Ntstatus.h.

Keterangan

Pengidentifikasi target VidPN ditetapkan oleh driver miniport tampilan. Fungsi DxgkDdiQueryChildRelations , yang diimplementasikan oleh driver miniport tampilan, mengembalikan array struktur DXGK_CHILD_DESCRIPTOR , yang masing-masing berisi pengidentifikasi.

Setelah selesai menggunakan pegangan objek set mode sumber monitor, Anda harus melepaskan handel dengan memanggil pfnReleaseMonitorSourceModeSet. Objek set mode target dihitung referensi, jadi jika Anda memperoleh handel beberapa kali, Anda harus merilisnya dalam jumlah yang sama.

Fungsi ini juga tersedia di antarmuka DXGK_MONITOR_INTERFACE_V2 yang dimulai dengan Windows 7.

Persyaratan

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

Lihat juga

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality