Fungsi D3DKMTSetDisplayMode (d3dkmthk.h)
Fungsi D3DKMTSetDisplayMode mengatur alokasi yang digunakan untuk memindai ke layar.
Sintaks
NTSTATUS D3DKMTSetDisplayMode(
[in, out] const D3DKMT_SETDISPLAYMODE *unnamedParam1
);
Parameter
[in, out] unnamedParam1
Penunjuk ke struktur D3DKMT_SETDISPLAYMODE yang menjelaskan alokasi yang digunakan untuk memindai.
Mengembalikan nilai
D3DKMTSetDisplayMode mengembalikan salah satu nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_SUCCESS | Mode tampilan berhasil disetel. |
| STATUS_DEVICE_REMOVED | Adaptor grafis dihentikan atau perangkat tampilan direset. |
| STATUS_INVALID_PARAMETER | Parameter divalidasi dan ditentukan salah. |
| STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER | Sebelum panggilan ke D3DKMTSetDisplayMode, perangkat tidak memperoleh kepemilikan eksklusif atas tampilan. Oleh karena itu, perangkat tidak dapat mengatur mode tampilan. |
| D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT | Driver klien yang dapat diinstal OpenGL (ICD) harus mengonversi format permukaan yang terkait dengan alokasi yang ditentukan anggota hPrimaryAllocationD3DKMT_SETDISPLAYMODE ke dalam atribut format yang ditentukan anggota PrivateDriverFormatAttributedari D3DKMT_SETDISPLAYMODE . ICD kemudian harus memanggil D3DKMTSetDisplayMode lagi. ICD dapat mengalokasikan alokasi baru, melakukan transfer bit-block konversi (bitblt) dari primer lama ke yang baru, dan kemudian menghancurkan primer lama selama ICD menggunakan handel alokasi baru untuk alokasi ini untuk semua operasi berikutnya. ICD harus mengulangi proses ini hingga D3DKMTSetDisplayMode mengembalikan nilai pengembalian yang berbeda. |
Fungsi ini mungkin juga mengembalikan nilai NTSTATUS lainnya.
Keterangan
Sebelum OpenGL ICD memanggil D3DKMTSetDisplayMode untuk mengatur mode tampilan baru yang menggunakan format yang diperluas, metode multi-pengambilan sampel, atau keduanya, ICD harus memastikan bahwa mode tampilan GDI saat ini memiliki resolusi yang sama dengan mode tampilan baru. Jika tidak, D3DKMTSetDisplayMode mengembalikan STATUS_INVALID_PARAMETER.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Target Platform | Universal |
| Header | d3dkmthk.h (termasuk D3dkmthk.h) |
| Pustaka | Gdi32.lib |
| DLL | Gdi32.dll |