DXGKDDI_VIDPN_ACQUIRESOURCEMODESET fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi pfnAcquireSourceModeSet mengembalikan handel ke objek set mode sumber tertentu yang dimuat oleh objek VidPN tertentu.

Sintaks

DXGKDDI_VIDPN_ACQUIRESOURCEMODESET DxgkddiVidpnAcquiresourcemodeset;

NTSTATUS DxgkddiVidpnAcquiresourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phVidPnSourceModeSet,
  [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] phVidPnSourceModeSet

Penunjuk ke variabel yang menerima handel ke objek set mode sumber yang diminta.

[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 pfnAcquireSourceModeSet mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_GRAPHICS_INVALID_VIDPN	Handel yang disediakan dalam hVidPn tidak valid.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE	Pengidentifikasi yang disediakan dalam VidPnSourceId tidak valid.

Keterangan

Pengidentifikasi sumber VidPN ditetapkan oleh sistem operasi. DxgkDdiStartDevice, yang diimplementasikan oleh driver miniport tampilan, mengembalikan jumlah N sumber video yang ada yang didukung oleh adaptor tampilan. Kemudian sistem operasi menetapkan pengidentifikasi 0, 1, 2, ... N - 1.

Setelah selesai menggunakan handel objek set mode sumber, Anda harus merilis handel dengan memanggil pfnReleaseSourceModeSet. Objek set mode sumber dihitung referensi, jadi jika Anda memperoleh handel beberapa kali, Anda harus merilisnya dalam jumlah yang sama.

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 D3DDDI_VIDEO_PRESENT_SOURCE_ID ditentukan dalam D3dukmdt.h.

Jenis data D3DKMDT_HVIDPN dan D3DKMDT_HVIDPNSOURCEMODESET ditentukan dalam D3dkmdt.h.