Fungsi CreateDXGIFactory1 (dxgi.h)

Artikel
02/26/2024

Membuat pabrik DXGI 1.1 yang dapat Anda gunakan untuk menghasilkan objek DXGI lainnya.

Sintaks

HRESULT CreateDXGIFactory1(
        REFIID riid,
  [out] void   **ppFactory
);

Parameter

riid

Jenis: REFIID

Pengidentifikasi unik global (GUID) dari objek IDXGIFactory1 yang dirujuk oleh parameter ppFactory .

[out] ppFactory

Jenis: batal**

Alamat pointer ke objek IDXGIFactory1 .

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil; kode kesalahan jika tidak. Untuk daftar kode kesalahan, lihat DXGI_ERROR.

Keterangan

Gunakan pabrik DXGI 1.1 untuk menghasilkan objek yang menghitung adaptor, membuat rantai pertukaran, dan mengaitkan jendela dengan urutan kunci alt+enter untuk beralih ke dan dari mode tampilan layar penuh.

Jika fungsi CreateDXGIFactory1 berhasil, jumlah referensi pada antarmuka IDXGIFactory1 bertambah. Untuk menghindari kebocoran memori, ketika Anda selesai menggunakan antarmuka, panggil metode IDXGIFactory1::Release untuk merilis antarmuka.

Titik masuk ini tidak didukung oleh DXGI 1.0, yang dikirim di Windows Vista dan Windows Server 2008. Dukungan DXGI 1.1 diperlukan, yang tersedia pada Windows 7, Windows Server 2008 R2, dan sebagai pembaruan untuk Windows Vista dengan Paket Layanan 2 (SP2) (KB 971644) dan Windows Server 2008 (KB 971512).

Catatan Jangan mencampur penggunaan DXGI 1.0 (IDXGIFactory) dan DXGI 1.1 (IDXGIFactory1) dalam aplikasi. Gunakan IDXGIFactory atau IDXGIFactory1, tetapi tidak keduanya dalam aplikasi.

CatatanCreateDXGIFactory1 gagal jika fungsi DllMain aplikasi Anda memanggilnya. Untuk informasi selengkapnya tentang cara DXGI merespons dari DllMain, lihat Respons DXGI dari DLLMain.

Catatan Dimulai dengan Windows 8, semua pabrik DXGI (terlepas dari apakah mereka dibuat dengan CreateDXGIFactory atau CreateDXGIFactory1) menghitung adaptor secara identik. Urutan enumerasi adaptor, yang Anda ambil dengan IDXGIFactory::EnumAdapters atau IDXGIFactory1::EnumAdapters1, adalah sebagai berikut:

Adaptor dengan output tempat primer desktop ditampilkan. Adaptor ini sesuai dengan indeks nol.
Adaptor dengan output.
Adaptor tanpa output.

Contoh

Membuat Pabrik DXGI 1.1

Contoh kode berikut menunjukkan cara membuat pabrik DXGI 1.1. Contoh ini menggunakan intrinsik __uuidof() untuk mendapatkan REFIID, atau GUID, dari antarmuka IDXGIFactory1 .


IDXGIFactory1 * pFactory;
HRESULT hr = CreateDXGIFactory1(__uuidof(IDXGIFactory1), (void**)(&pFactory) );

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	dxgi.h
Pustaka	DXGI.lib
DLL	Dxgi.dll

Lihat juga

Fungsi DXGI

Share via