DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Fungsi pfnCreateNewModeInfo mengembalikan pointer ke struktur D3DKMDT_VIDPN_TARGET_MODE yang diisi driver miniport tampilan sebelum memanggil pfnAddMode.

Sintaks

DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO DxgkddiVidpntargetmodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_TARGET_MODE ppNewVidPnTargetModeInfo
)
{...}

Parameter

[in] hVidPnTargetModeSet

Handel ke objek set mode target VidPN. Driver miniport tampilan sebelumnya memperoleh handel ini dengan memanggil fungsi pfnAcquireTargetModeSet dari antarmuka DXGK_VIDPN_INTERFACE .

[out] ppNewVidPnTargetModeInfo

Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_VIDPN_TARGET_MODE yang dialokasikan oleh manajer VidPN.

Menampilkan nilai

Fungsi pfnCreateNewModeInfo mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	Handel yang disediakan dalam hVidPnTargetModeSet tidak valid.

Keterangan

Fungsi pfnCreateNewModeInfo mengalokasikan struktur D3DKMDT_VIDPN_TARGET_MODE dan mengatur anggota Id-nya ke pengidentifikasi yang baru dibuat.

Setelah Anda memanggil pfnCreateNewModeInfo untuk mendapatkan struktur D3DKMDT_VIDPN_TARGET_MODE, Anda harus melakukannya, tetapi tidak keduanya, dari yang berikut ini:

Isi anggota Info struktur dan teruskan struktur ke pfnAddMode.
Lepaskan struktur dengan memanggil pfnReleaseModeInfo.

Saat Anda mengisi struktur D3DKMDT_VIDPN_TARGET_MODE, Anda memiliki opsi untuk menimpa anggota Id yang dihasilkan dan diatur oleh pfnCreateNewModeInfo. Namun, jika Anda menimpa anggota Id dari struktur D3DKMDT_VIDPN_TARGET_MODE apa pun, Anda harus menimpa anggota Id dari semua struktur D3DKMDT_VIDPN_TARGET_MODE yang Anda peroleh dari pfnCreateNewModeInfo. Kecuali Anda memiliki alasan khusus untuk menimpa anggota Id (misalnya, melacak mode target dengan skema penomoran Anda sendiri), Anda harus membiarkannya sebagaimana diatur oleh pfnCreateNewModeInfo.

Jenis data D3DKMDT_HVIDPNTARGETMODESET ditentukan dalam D3dkmdt.h.