Fungsi CreateDXGIFactory (dxgi.h)

Artikel
08/23/2023

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

Sintaks

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

Parameter

riid

Jenis: REFIID

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

[out] ppFactory

Jenis: void**

Alamat penunjuk ke objek IDXGIFactory .

Menampilkan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil; jika tidak, mengembalikan salah satu DXGI_ERROR berikut.

Keterangan

Gunakan pabrik DXGI 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 CreateDXGIFactory berhasil, jumlah referensi pada antarmuka IDXGIFactory akan bertambah. Untuk menghindari kebocoran memori, ketika Anda selesai menggunakan antarmuka , panggil metode IDXGIFactory::Release untuk merilis antarmuka.

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

CatatanCreateDXGIFactory 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.

Fungsi CreateDXGIFactory tidak ada untuk aplikasi Windows Store. Sebagai gantinya, aplikasi Windows Store menggunakan fungsi CreateDXGIFactory1 .

Contoh

Membuat Pabrik DXGI 1.0

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


IDXGIFactory * pFactory;
HRESULT hr = CreateDXGIFactory(__uuidof(IDXGIFactory), (void**)(&pFactory) );

Persyaratan


Target Platform	Windows
Header	dxgi.h
Pustaka	DXGI.lib
DLL	DXGI.dll

Lihat juga

Fungsi DXGI

Bagikan melalui