DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Fungsi pfnReleaseModeInfo merilis struktur D3DKMDT_VIDPN_TARGET_MODE yang sebelumnya disediakan manajer VidPN untuk driver miniport tampilan.

Sintaks

DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO DxgkddiVidpntargetmodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_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 akan dilepaskan.

Menampilkan nilai

Fungsi pfnReleaseModeInfo mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	Handel yang disediakan dalam hVidPnTargetModeSet tidak valid.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE	Pointer yang disediakan dalam pVidPnTargetModeInfo tidak valid.

Keterangan

Setelah selesai menggunakan struktur D3DKMDT_VIDPN_TARGET_MODE yang Anda peroleh dengan memanggil salah satu fungsi berikut, Anda harus merilis struktur dengan memanggil pfnReleaseModeInfo.

Jika Anda mendapatkan struktur D3DKMDT_VIDPN_TARGET_MODE dengan memanggil pfnCreateNewModeInfo dan kemudian meneruskan struktur tersebut ke pfnAddMode, Anda tidak perlu merilis struktur.

Jika Anda mendapatkan handel dengan memanggil pfnCreateNewModeInfo dan kemudian Anda memutuskan untuk tidak menambahkan mode baru ke set mode target, Anda harus merilis struktur yang baru dibuat dengan memanggil pfnReleaseModeInfo.

Jenis data D3DKMDT_HVIDPNSOURCEMODESET ditentukan dalam D3dkmdt.h.