DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Fungsi pfnCreateNewModeInfo mengembalikan penunjuk ke struktur D3DKMDT_VIDPN_SOURCE_MODE yang diisi driver miniport tampilan sebelum memanggil pfnAddMode.

Sintaks

DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO DxgkddiVidpnsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_SOURCE_MODE ppNewVidPnSourceModeInfo
)
{...}

Parameter

[in] hVidPnSourceModeSet

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

[out] ppNewVidPnSourceModeInfo

Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_VIDPN_SOURCE_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_SOURCEMODESET	Handel yang disediakan dalam hVidPnSourceModeSet tidak valid.

Keterangan

Fungsi pfnCreateNewModeInfo mengalokasikan struktur D3DKMDT_VIDPN_SOURCE_MODE , mengatur anggota Id-nya ke pengidentifikasi yang baru dibuat, dan mengatur anggota Jenisnya ke D3DKMDT_RMT_UNINITIALIZED.

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

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

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

Jenis data D3DKMDT_HVIDPNSOURCEMODESET ditentukan dalam D3dkmdt.h.