DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

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

Sintaks

DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO DxgkddiVidpnsourcemodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_CONST_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 akan dirilis.

Menampilkan nilai

Fungsi pfnReleaseModeInfo mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	Handel yang disediakan dalam hVidPnSourceModeSet tidak valid.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE_MODE	Pointer yang disediakan dalam pVidPnSourceModeInfo tidak valid.

Keterangan

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

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

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

Jenis data D3DKMDT_HVIDPNSOURCEMODESET ditentukan dalam D3dkmdt.h.