Fungsi D3DKMTGetDisplayModeList (d3dkmthk.h)

Fungsi D3DKMTGetDisplayModeList mengambil daftar mode tampilan yang tersedia, termasuk mode dengan format yang diperluas.

Sintaksis

NTSTATUS D3DKMTGetDisplayModeList(
  D3DKMT_GETDISPLAYMODELIST *unnamedParam1
);

Parameter

unnamedParam1

[in/out] pData adalah penunjuk ke struktur D3DKMT_GETDISPLAYMODELIST yang berisi argumen untuk fungsi ini.

Mengembalikan nilai

D3DKMTGetDisplayModeList mengembalikan nilai NTSTATUS seperti salah satu yang berikut ini.

Mengembalikan kode	Deskripsi
STATUS_SUCCESS	Daftar mode tampilan yang tersedia berhasil diambil, atau jumlah mode tampilan dikembalikan dalam mode pData->ModeCount jika pData->pModeList null dan pData->ModeCount nol pada input.
STATUS_DEVICE_REMOVED	Adaptor grafis dihentikan.
STATUS_BUFFER_TOO_SMALL	Buffer yang disediakan driver klien dalam pData->pModeList tidak cukup besar untuk berisi daftar mode tampilan yang diminta.
STATUS_GRAPHICS_NO_AVAILABLE_VIDPN_TARGET	Tidak ada target video yang tersedia untuk digunakan dengan sumber sajikan video yang diidentifikasi oleh pData->VidPnSourceId. Oleh karena itu, tidak ada mode tampilan yang tersedia untuk sumber ini.
STATUS_INVALID_PARAMETER**	Parameter divalidasi dan ditentukan salah.

Komentar

Untuk mendapatkan jumlah mode tampilan untuk sumber VidPn yang ditentukan (pData-VidPnSourceId) pada adaptor grafis (pData-hAdapter), driver klien dapat panggil D3DKMTGetDisplayModeList dengan pData-pModeList diatur ke NULL dan pData-ModeCount sebagai 0. Jika panggilan ini mengembalikan STATUS_SUCCESS, yang dikembalikan pData-ModeCount adalah jumlah total mode tampilan. Driver klien kemudian dapat mengalokasikan array strukturD3DKMT_DISPLAYMODE ModeCount, mengatur pModeList untuk menunjuk ke array ini, dan memanggil D3DKMTGetDisplayModeList lagi untuk mengambil daftar mode tampilan.

Atribut tampilan pada sumber VidPn yang ditentukan dapat diubah di antara kedua panggilan ini, menyebabkan daftar mode tampilan diubah. Dalam hal ini, jika array D3DKMT_DISPLAYMODE yang disediakan penelepon tidak cukup besar untuk menahan daftar mode tampilan baru, fungsi ini akan mengembalikan STATUS_BUFFER_TOO_SMALL dengan jumlah mode tampilan baru dalam mode ModeCount yang dikembalikan. Pemanggil dapat membebaskan array D3DKMT_DISPLAYMODE sebelumnya, mengalokasikan array D3DKMT_DISPLAYMODE baru berdasarkan nomor yang dikembalikan baru, dan memanggil fungsi ini lagi dengan nomor baru dan array D3DKMT_DISPLAYMODE baru untuk mendapatkan daftar mode tampilan baru.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista
Platform Target	Universal
Header	d3dkmthk.h (termasuk D3dkmthk.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Lihat juga

D3DKMT_DISPLAYMODE

D3DKMT_GETDISPLAYMODELIST