DXGKDDI_VIDPN_CREATENEWSOURCEMODESET fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi pfnCreateNewSourceModeSet membuat objek set mode sumber baru dalam objek VidPN tertentu.

Sintaks

DXGKDDI_VIDPN_CREATENEWSOURCEMODESET DxgkddiVidpnCreatenewsourcemodeset;

NTSTATUS DxgkddiVidpnCreatenewsourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phNewVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}

Parameter

[in] hVidPn

Handel ke objek VidPN. Manajer VidPN sebelumnya memberikan handel ini ke driver miniport tampilan dengan memanggil DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn, atau DxgkDdiRecommendFunctionalVidPn.

[in] VidPnSourceId

Bilangan bulat yang mengidentifikasi salah satu video yang menyajikan sumber yang terkait dengan objek VidPN.

[out] phNewVidPnSourceModeSet

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

[out] ppVidPnSourceModeSetInterface

Penunjuk ke variabel yang menerima penunjuk ke struktur DXGK_VIDPNSOURCEMODESET_INTERFACE . Struktur berisi pointer ke fungsi yang dapat dipanggil driver miniport tampilan untuk memeriksa dan mengubah objek set mode sumber.

Menampilkan nilai

Fungsi pfnCreateNewSourceModeSet 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 sumber baru.

Keterangan

Untuk menetapkan mode sumber baru yang diatur ke sumber tertentu di VidPN, lakukan langkah-langkah berikut:

Panggil pfnCreateNewSourceModeSet untuk mendapatkan handel ke objek set mode sumber baru. Objek set mode sumber tersebut milik objek VidPN tertentu yang Anda tentukan.
Gunakan fungsi antarmuka DXGK_VIDPNSOURCEMODESET_INTERFACE untuk menambahkan mode ke objek set mode sumber.
Panggil pfnAssignSourceModeSet untuk menetapkan mode sumber baru yang diatur ke sumber tertentu.

Jika Anda mendapatkan handel dengan memanggil pfnCreateNewSourceModeSet lalu meneruskan handel tersebut ke pfnAssignSourceModeSet, Anda tidak perlu melepaskan handel dengan memanggil pfnReleaseSourceModeSet.

Jika Anda mendapatkan handel dengan memanggil pfnCreateNewSourceModeSet dan kemudian Anda memutuskan untuk tidak menetapkan mode sumber baru yang diatur ke sumber, Anda harus merilis handel yang baru diperoleh dengan memanggil pfnReleaseSourceModeSet.

Masa pakai struktur DXGK_VIDPNSOURCEMODESET_INTERFACE yang dikembalikan dalam ppVidPnSourceModeSetInterface 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_HVIDPNSOURCEMODESET ditentukan dalam D3dkmdt.h.