DXGKDDI_VIDPNSOURCEMODESET_ADDMODE fungsi panggilan balik (d3dkmddi.h)
Fungsi pfnAddMode menambahkan mode sumber VidPN ke objek set mode sumber VidPN tertentu.
Sintaks
DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;
NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
[in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
[in] IN_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 menjelaskan mode sumber. Driver miniport tampilan sebelumnya memperoleh struktur ini dengan memanggil pfnCreateNewModeInfo.
Menampilkan nilai
Fungsi pfnAddMode mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
STATUS_SUCCESS | Fungsi berhasil. |
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | Handel yang disediakan dalam hVidPnSourceModeSet tidak valid. |
Keterangan
Untuk menambahkan mode ke set mode sumber, driver miniport tampilan melakukan langkah-langkah berikut.
Panggil pfnCreateNewModeInfo untuk mendapatkan penunjuk ke struktur D3DKMDT_VIDPN_SOURCE_MODE . Fungsi pnfCreateNewModeInfo mengalokasikan struktur, mengisi anggota Id dengan pengidentifikasi mode sumber yang baru dibuat, dan mengatur anggota Jenis ke D3DKMDT_RMT_UNINITIALIZED.
Isi struktur D3DKMDT_VIDPN_SOURCE_MODE (kecuali untuk anggota Id ) dengan informasi tentang mode, termasuk jenis dan format mode.
Panggil pfnAddMode untuk menambahkan mode ke set mode sumber.
Manajer VidPN mengalokasikan struktur D3DKMDT_VIDPN_SOURCE_MODE saat Anda memanggil pfnCreateNewModeInfo. Jika Anda menambahkan mode yang dijelaskan oleh struktur tersebut ke set mode sumber, Anda tidak perlu melepaskan struktur secara eksplisit; pfnAddMode merilisnya.
Jika Anda mendapatkan struktur D3DKMDT_VIDPN_SOURCE_MODE dengan memanggil pfnCreateNewModeInfo lalu memutuskan untuk tidak menambahkan mode tersebut ke set mode sumber, Anda harus secara eksplisit melepaskan struktur dengan memanggil pfnReleaseModeInfo.
Jenis data 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 |