METODE IDXGIFactory1::EnumAdapters1 (dxgi.h)

  • Artikel

Menghitung adaptor (kartu video) dengan atau tanpa output.

Sintaks

HRESULT EnumAdapters1(
        UINT          Adapter,
  [out] IDXGIAdapter1 **ppAdapter
);

Parameter

Adapter

Jenis: UINT

Indeks adaptor yang akan dijumlahkan.

[out] ppAdapter

Jenis: IDXGIAdapter1**

Alamat penunjuk ke antarmuka IDXGIAdapter1 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

Metode 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).

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 IDXGIFactory1 . Jumlah adaptor dalam sistem berubah saat Anda menambahkan atau menghapus kartu tampilan, atau menambatkan atau melepas dock laptop.

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

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

Contoh

Menghitung Adapter

Contoh kode berikut menunjukkan cara menghitung adaptor menggunakan metode EnumAdapters1 .


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

Persyaratan

   
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

Lihat juga

Antarmuka DXGI

IDXGIFactory1