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 |