METODE IDXGIAdapter::EnumOutputs (dxgi.h)

  • Artikel

Menghitung output adaptor (kartu video).

Sintaks

HRESULT EnumOutputs(
        UINT        Output,
  [out] IDXGIOutput **ppOutput
);

Parameter

Output

Jenis: UINT

Indeks output.

[out] ppOutput

Jenis: IDXGIOutput**

Alamat penunjuk ke antarmuka IDXGIOutput pada posisi yang ditentukan oleh parameter Output .

Mengembalikan nilai

Jenis: HRESULT

Kode yang menunjukkan keberhasilan atau kegagalan (lihat DXGI_ERROR). DXGI_ERROR_NOT_FOUND dikembalikan jika indeks lebih besar dari jumlah output.

Jika adaptor berasal dari perangkat yang dibuat menggunakan D3D_DRIVER_TYPE_WARP, maka adaptor tidak memiliki output, sehingga DXGI_ERROR_NOT_FOUND dikembalikan.

Keterangan

Catatan Jika Anda memanggil API ini dalam proses Sesi 0, api akan mengembalikan DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.
 
Ketika metode EnumOutputs berhasil dan mengisi parameter ppOutput dengan alamat penunjuk ke antarmuka output, EnumOutputs meningkatkan jumlah referensi antarmuka output. Untuk menghindari kebocoran memori, ketika Anda selesai menggunakan antarmuka output, panggil metode Rilis untuk mengurangi jumlah referensi.

EnumOutputs pertama-tama mengembalikan output tempat primer desktop ditampilkan. Output ini sesuai dengan indeks nol. EnumOutputs kemudian mengembalikan output lainnya.

Contoh

Menghitung Output

Berikut adalah contoh cara menggunakan EnumOutputs untuk menghitung semua output pada adaptor:


UINT i = 0;
IDXGIOutput * pOutput;
std::vector<IDXGIOutput*> vOutputs;
while(pAdapter->EnumOutputs(i, &pOutput) != DXGI_ERROR_NOT_FOUND)
{
    vOutputs.push_back(pOutput);
    ++i;
}

Persyaratan

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

Lihat juga

Antarmuka DXGI

IDXGIAdapter