METODE IDXGIFactory::EnumAdapters (dxgi.h)

Menghitung adaptor (kartu video).

Sintaks

HRESULT EnumAdapters(
        UINT         Adapter,
  [out] IDXGIAdapter **ppAdapter
);

Parameter

Adapter

Jenis: UINT

Indeks adaptor yang akan dijumlahkan.

[out] ppAdapter

Jenis: IDXGIAdapter**

Alamat penunjuk ke antarmuka IDXGIAdapter pada posisi yang ditentukan oleh parameter Adapter . Parameter ini tidak boleh NULL.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil; jika tidak, mengembalikan DXGI_ERROR_NOT_FOUND jika indeks lebih besar dari atau sama dengan jumlah adaptor dalam sistem lokal, atau DXGI_ERROR_INVALID_CALL jika parameter ppAdapterADALAH NULL.

Keterangan

Saat Anda membuat pabrik, pabrik menghitung set adaptor yang tersedia dalam sistem. Oleh karena itu, jika Anda mengubah adaptor dalam sistem, Anda harus menghancurkan dan membuat ulang objek IDXGIFactory . Jumlah adaptor dalam sistem berubah saat Anda menambahkan atau menghapus kartu tampilan, atau menambatkan atau melepas dock laptop.

Ketika metode EnumAdapters berhasil dan mengisi parameter ppAdapter dengan alamat penunjuk ke antarmuka adaptor, EnumAdapters menambah jumlah referensi antarmuka adaptor. Setelah Anda selesai menggunakan antarmuka adaptor, panggil metode Rilis untuk mengurangi jumlah referensi sebelum Anda menghancurkan penunjuk.

EnumAdapters pertama-tama mengembalikan adaptor dengan output tempat primer desktop ditampilkan. Adaptor ini sesuai dengan indeks nol. EnumAdapters selanjutnya mengembalikan adaptor lain dengan output. EnumAdapters akhirnya mengembalikan adaptor tanpa output.

Contoh

Menghitung Adapter

Contoh kode berikut menunjukkan cara menghitung adaptor menggunakan metode EnumAdapters .


UINT i = 0; 
IDXGIAdapter * pAdapter; 
std::vector <IDXGIAdapter*> vAdapters; 
while(pFactory->EnumAdapters(i, &pAdapter) != DXGI_ERROR_NOT_FOUND) 
{ 
	vAdapters.push_back(pAdapter); 
	++i; 
} 

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header dxgi.h
Pustaka DXGI.lib

Lihat juga

Antarmuka DXGI

IDXGIFactory