DXGKDDI_VIDPNSOURCEMODESET_ADDMODE fungsi panggilan balik (d3dkmddi.h)

Artikel
04/18/2024

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

Sintaks

DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;

NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

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 .

[in] pVidPnSourceModeInfo

Penunjuk ke struktur D3DKMDT_VIDPN_SOURCE_MODE yang menjelaskan mode sumber. 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_SOURCEMODESET	Handel yang disediakan dalam hVidPnSourceModeSet tidak valid.

Keterangan

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

Panggil pfnCreateNewModeInfo untuk mendapatkan penunjuk ke struktur D3DKMDT_VIDPN_SOURCE_MODE . Fungsi pnfCreateNewModeInfo mengalokasikan struktur, mengisi anggota Id dengan pengidentifikasi mode sumber yang baru dibuat, dan mengatur anggota Jenis ke D3DKMDT_RMT_UNINITIALIZED.

Isi struktur D3DKMDT_VIDPN_SOURCE_MODE (kecuali untuk anggota Id ) dengan informasi tentang mode, termasuk jenis dan format mode.

Panggil pfnAddMode untuk menambahkan mode ke set mode sumber.

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

Jika Anda mendapatkan struktur D3DKMDT_VIDPN_SOURCE_MODE dengan memanggil pfnCreateNewModeInfo lalu memutuskan untuk tidak menambahkan mode tersebut ke set mode sumber, Anda harus secara eksplisit melepaskan struktur dengan memanggil pfnReleaseModeInfo.

Jenis data D3DKMDT_HVIDPNSOURCEMODESET ditentukan dalam D3dkmdt.h.