DXGKDDI_VIDPN_ACQUIRETARGETMODESET fungsi panggilan balik (d3dkmddi.h)
Fungsi pfnAcquireTargetModeSet mengembalikan handel ke objek set mode target tertentu yang dimuat oleh objek VidPN tertentu.
Sintaks
DXGKDDI_VIDPN_ACQUIRETARGETMODESET DxgkddiVidpnAcquiretargetmodeset;
NTSTATUS DxgkddiVidpnAcquiretargetmodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterface
)
{...}
Parameter
[in] hVidPn
Handel ke objek VidPN. Manajer VidPN sebelumnya memberikan handel ini ke driver miniport tampilan dengan memanggil DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn, atau DxgkDdiRecommendFunctionalVidPn.
[in] VidPnTargetId
Bilangan bulat yang mengidentifikasi salah satu video yang menyajikan target yang terkait dengan objek VidPN.
[out] phVidPnTargetModeSet
Penunjuk ke variabel yang menerima handel ke objek set mode target yang diminta.
[out] ppVidPnTargetModeSetInterface
Penunjuk ke variabel yang menerima penunjuk ke struktur DXGK_VIDPNTARGETMODESET_INTERFACE . Struktur berisi pointer ke fungsi yang dapat dipanggil driver miniport tampilan untuk memeriksa dan mengubah objek set mode target.
Menampilkan nilai
Fungsi pfnAcquireTargetModeSet mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
STATUS_SUCCESS | Fungsi berhasil. |
STATUS_GRAPHICS_INVALID_VIDPN | Handel yang disediakan dalam hVidPn tidak valid. |
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET | Pengidentifikasi yang disediakan dalam VidPnTargetId tidak valid. |
Keterangan
Pengidentifikasi target VidPN ditetapkan oleh driver miniport tampilan. DxgkDdiQueryChildRelations, yang diimplementasikan oleh driver miniport tampilan, mengembalikan array struktur DXGK_CHILD_DESCRIPTOR , yang masing-masing berisi pengidentifikasi.
Setelah selesai menggunakan handel objek set mode target, Anda harus melepaskan handel dengan memanggil pfnReleaseTargetModeSet. Objek set mode target dihitung referensi, jadi jika Anda memperoleh handel beberapa kali, Anda harus merilisnya dalam jumlah yang sama.
Masa pakai struktur DXGK_VIDPNTARGETMODESET_INTERFACE yang dikembalikan dalam ppVidPnTargetModeSetInterface dimiliki oleh sistem operasi. Dengan menggunakan skema kepemilikan ini, sistem operasi dapat beralih ke implementasi yang lebih baru pada durasi tanpa merusak klien antarmuka.
Jenis data D3DDDI_VIDEO_PRESENT_TARGET_ID ditentukan dalam D3dukmdt.h.
Jenis data D3DKMDT_HVIDPN dan D3DKMDT_HVIDPNTARGETMODESET ditentukan dalam D3dkmdt.h.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista |
Target Platform | Desktop |
Header | d3dkmddi.h (termasuk D3dkmddi.h) |
IRQL | PASSIVE_LEVEL |