IDXGIFactory：：EnumAdapters 方法 (dxgi.h)
列舉 (視訊卡) 的適配卡。
語法
HRESULT EnumAdapters(
UINT Adapter,
[out] IDXGIAdapter **ppAdapter
);
參數
Adapter
類型： UINT
要列舉之配接器的索引。
[out] ppAdapter
類型： IDXGIAdapter**
IDXGIAdapter 介面指標的位址，位於 Adapter 參數所指定的位置。 此參數不得為 NULL。
傳回值
類型： HRESULT
如果成功，則傳回S_OK;否則，如果索引大於或等於本機系統中的配接器數目，則傳回DXGI_ERROR_NOT_FOUND，如果 ppAdapter 參數為 NULL，則傳回DXGI_ERROR_INVALID_CALL。
備註
當您建立處理站時，Factory 會列舉系統中可用的配接器集合。 因此，如果您變更系統中的配接器，則必須終結並重新建立 IDXGIFactory 物件。 當您新增或移除顯示卡片，或停駐或取消停駐膝上型計算機時，系統內的適配卡數目會變更。
當 EnumAdapters 方法成功並填入 ppAdapter 參數的配接器介面指標位址時， EnumAdapters 會遞增配接器介面的參考計數。 當您完成使用配接器介面時，請先呼叫 Release 方法來遞減參考計數，再終結指標。
EnumAdapters 會先傳回配接器，其中包含顯示桌面主要複本的輸出。 此配接器會對應至零的索引。 EnumAdapters 接著會傳回其他具有輸出的適配卡。 EnumAdapters 最後會傳回沒有輸出的配接器。
範例
列舉配接器
下列程式代碼範例示範如何使用 EnumAdapters 方法來列舉配接器。
UINT i = 0;
IDXGIAdapter * pAdapter;
std::vector <IDXGIAdapter*> vAdapters;
while(pFactory->EnumAdapters(i, &pAdapter) != DXGI_ERROR_NOT_FOUND)
{
vAdapters.push_back(pAdapter);
++i;
}
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | dxgi.h |
| 程式庫 | DXGI.lib |