DXGKDDI_VIDPNTARGETMODESET_ADDMODE fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi pfnAddMode menambahkan mode target VidPN ke objek set mode target VidPN tertentu.

Sintaks

DXGKDDI_VIDPNTARGETMODESET_ADDMODE DxgkddiVidpntargetmodesetAddmode;

NTSTATUS DxgkddiVidpntargetmodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

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 .

[in] pVidPnTargetModeInfo

Penunjuk ke struktur D3DKMDT_VIDPN_TARGET_MODE yang menjelaskan mode target. Driver miniport tampilan sebelumnya memperoleh struktur ini dengan memanggil pfnCreateNewModeInfo.

Menampilkan nilai

Fungsi pfnAddMode 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

Untuk menambahkan mode ke set mode target, driver miniport tampilan melakukan langkah-langkah berikut.

Panggil pfnCreateNewModeInfo untuk mendapatkan pointer ke struktur D3DKMDT_VIDPN_TARGET_MODE . Fungsi pnfCreateNewModeInfo mengalokasikan struktur dan mengisi anggota Id dengan pengidentifikasi mode target yang baru dibuat.
Anggota Info dari struktur D3DKMDT_VIDPN_TARGET_MODE adalah struktur D3DKMDT_VIDEO_SIGNAL_MODE . Isi struktur tersebut dengan informasi tentang mode .
Panggil pfnAddMode untuk menambahkan mode ke set mode target.

Manajer VidPN mengalokasikan struktur D3DKMDT_VIDPN_TARGET_MODE saat Anda memanggil pfnCreateNewModeInfo. Jika Anda menambahkan mode yang dijelaskan oleh struktur tersebut ke set mode target, Anda tidak perlu melepaskan struktur secara eksplisit; pfnAddMode merilisnya.

Jika Anda mendapatkan struktur D3DKMDT_VIDPN_TARGET_MODE dengan memanggil pfnCreateNewModeInfo dan kemudian memutuskan untuk tidak menambahkan mode tersebut ke set mode target, Anda harus secara eksplisit melepaskan struktur dengan memanggil pfnReleaseModeInfo.

Jenis data D3DKMDT_HVIDPNTARGETMODESET ditentukan dalam D3dkmdt.h.