DXGKDDI_VIDPN_ASSIGNSOURCEMODESET fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Fungsi pfnAssignSourceModeSet menetapkan mode sumber yang diatur ke sumber tertentu dalam VidPN tertentu.

Sintaks

DXGKDDI_VIDPN_ASSIGNSOURCEMODESET DxgkddiVidpnAssignsourcemodeset;

NTSTATUS DxgkddiVidpnAssignsourcemodeset(
  [in] IN_D3DKMDT_HVIDPN hVidPn,
  [in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet
)
{...}

Parameter

[in] hVidPn

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

[in] VidPnSourceId

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

[in] hVidPnSourceModeSet

Handel ke objek set mode sumber yang akan ditetapkan ke sumber yang diidentifikasi oleh VidPnSourceId. Driver miniport tampilan sebelumnya mendapatkan handel ini dengan memanggil pfnCreateNewSourceModeSet.

Menampilkan nilai

Fungsi pfnAssignSourceModeSet 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.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	Handel yang disediakan dalam hVidPnSourceModeSet tidak valid.
STATUS_GRAPHICS_PINNED_MODE_MUST_REMAIN_IN_SET	Set mode sumber yang Anda coba tetapkan tidak berisi mode yang sudah disematkan pada sumbernya.

Keterangan

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

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.

Catatan Fungsi pfnAssignSourceModeSet merilis atau tidak merilis objek set mode sumber yang diidentifikasi oleh parameter hVidPnSourceModeSet tergantung pada alasan yang menyebabkan pfnAssignSourceModeSet gagal.

pfnAssignSourceModeSet tidak merilis objek set mode sumber jika pfnAssignSourceModeSet gagal dengan parameter input yang tidak valid (yaitu, gagal dengan kode kesalahan STATUS_GRAPHICS_INVALID_VIDPN, STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE, atau STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET) karena parameter yang ditentukan tidak cukup bagi sistem operasi untuk menentukan objek set mode mana yang akan dilepaskan. Situasi parameter yang tidak valid tersebut menunjukkan kesalahan pengkodian kotor di driver. Anda dapat memperbaiki kesalahan ini dengan menentukan handel VidPN yang benar, pengidentifikasi sumber, atau handel set mode sumber VidPN.

pfnAssignSourceModeSet akan merilis objek set mode sumber setelah berhasil memvalidasi semua parameter input jika pfnAssignSourceModeSet gagal karena salah satu alasan berikut:

Set mode sumber kosong.
Set mode sumber tidak berisi mode yang disematkan dalam set mode sebelumnya, jika ada.
Set mode sumber tidak dibuat untuk sumber yang diidentifikasi oleh VidPnSourceId.

Jenis data D3DDDI_VIDEO_PRESENT_SOURCE_ID ditentukan dalam D3dukmdt.h.

Jenis data D3DKMDT_HVIDPN dan D3DKMDT_HVIDPNSOURCEMODESET ditentukan dalam D3dkmdt.h.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Target Platform	Desktop
Header	d3dkmddi.h (termasuk D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Lihat juga

Antarmuka Set Mode Sumber VidPN

pfnCreateNewSourceModeSet