DXGKDDI_VIDPN_CREATENEWTARGETMODESET fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Fungsi pfnCreateNewTargetModeSet membuat objek set mode target baru dalam objek VidPN tertentu.

Sintaks

DXGKDDI_VIDPN_CREATENEWTARGETMODESET DxgkddiVidpnCreatenewtargetmodeset;

NTSTATUS DxgkddiVidpnCreatenewtargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phNewVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterace
)
{...}

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] phNewVidPnTargetModeSet

Penunjuk ke variabel yang menerima handel ke objek set mode target yang baru dibuat.

[out] ppVidPnTargetModeSetInterace

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 pfnCreateNewTargetModeSet mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_GRAPHICS_INVALID_VIDPN	Handel yang disediakan dalam hVidPn tidak valid.
STATUS_NO_MEMORY	Manajer VidPN tidak dapat mengalokasikan memori yang diperlukan untuk membuat objek set mode target baru.

Keterangan

Untuk menetapkan mode target baru yang diatur ke target tertentu dalam implementasi VidPN, lakukan langkah-langkah berikut:

Panggil pfnCreateNewTargetModeSet untuk mendapatkan handel ke objek set mode target baru. Objek set mode target tersebut milik objek VidPN tertentu yang Anda tentukan.
Gunakan fungsi struktur DXGK_VIDPNTARGETMODESET_INTERFACE untuk menambahkan mode ke objek set mode target.
Panggil pfnAssignTargetModeSet untuk menetapkan mode target baru yang diatur ke target tertentu.

Jika Anda mendapatkan handel dengan memanggil pfnCreateNewTargetModeSet lalu meneruskan handel tersebut ke pfnAssignTargetModeSet, Anda tidak perlu melepaskan handel dengan memanggil pfnReleaseTargetModeSet.

Jika Anda mendapatkan handel dengan memanggil pfnCreateNewTargetModeSet dan kemudian Anda memutuskan untuk tidak menetapkan mode target baru yang diatur ke target, Anda harus merilis handel yang baru diperoleh dengan memanggil pfnReleaseTargetModeSet.

Masa pakai struktur DXGK_VIDPNTARGETEMODESET_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 D3DKMDT_HVIDPN dan D3DKMDT_HVIDPNTARGETMODESET ditentukan dalam D3dkmdt.h.