IDXGIAdapter：：EnumOutputs 方法 (dxgi.h)

  • 發行項

列舉配接器 (視訊卡) 輸出。

語法

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

參數

Output

類型： UINT

輸出的索引。

[out] ppOutput

類型： IDXGIOutput**

在 Output 參數所指定位置的 IDXGIOutput 介面指標位址。

傳回值

類型： HRESULT

指出成功或失敗 (的程式代碼，請參閱 DXGI_ERROR) 。 如果索引大於輸出數目，則會傳回DXGI_ERROR_NOT_FOUND。

如果配接器來自使用 D3D_DRIVER_TYPE_WARP 建立的裝置，則配接器沒有輸出，因此會傳回DXGI_ERROR_NOT_FOUND。

備註

注意 如果您在會話 0 進程中呼叫此 API，它會傳回 DXGI_ERROR_NOT_CURRENTLY_AVAILABLE。
 
當 EnumOutputs 方法成功並填入 ppOutput 參數的輸出介面指標位址時， EnumOutputs 會遞增輸出介面的參考計數。 若要避免記憶體流失，當您完成使用輸出介面時，請呼叫 Release 方法來遞減參考計數。

EnumOutputs 會先傳回顯示桌面主要複本的輸出。 此輸出會對應至零的索引。 接著，EnumOutputs 會傳回其他輸出。

範例

列舉輸出

以下是如何使用 EnumOutputs 列舉配接器上所有輸出的範例：


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

規格需求

需求 值
目標平台 Windows
標頭 dxgi.h
程式庫 DXGI.lib

另請參閱

DXGI 介面

IDXGIAdapter