IDXGIFactory1：：EnumAdapters1 方法 (dxgi.h)
列舉兩個介面卡 (，) 沒有輸出。
語法
HRESULT EnumAdapters1(
UINT Adapter,
[out] IDXGIAdapter1 **ppAdapter
);
參數
Adapter
類型： UINT
要列舉之配接器的索引。
[out] ppAdapter
類型： IDXGIAdapter1**
IDXGIAdapter1介面指標的位址，位於Adapter參數所指定的位置。
此參數不得為 Null。
傳回值
類型： HRESULT
如果成功，則傳回S_OK;否則，如果索引大於或等於本機系統中的配接器數目，則傳回DXGI_ERROR_NOT_FOUND，如果ppAdapter參數為Null，則傳回DXGI_ERROR_INVALID_CALL。
備註
DXGI 1.0 不支援此方法，其隨附于 Windows Vista 和 Windows Server 2008。 需要 DXGI 1.1 支援，此支援適用于 Windows 7、Windows Server 2008 R2，以及以 Service Pack 2 (SP2) (KB) (KB 971644) 和 Windows Server 2008 (KB 971512) 更新。
當您建立處理站時，Factory 會列舉系統中可用的配接器集合。 因此，如果您變更系統中的配接器，則必須終結並重新建立 IDXGIFactory1 物件。 當您新增或移除顯示卡片，或停駐或取消停駐膝上型電腦時，系統內的介面卡數目會變更。
當 EnumAdapters1方法成功，並以配接器介面指標的位址填入ppAdapter參數時，EnumAdapters1會遞增配接器介面的參考計數。 當您完成使用配接器介面時，請先呼叫 Release 方法來遞減參考計數，再終結指標。
EnumAdapters1 會先傳回配接器，其中顯示桌面主要複本的輸出。 此配接器會對應至零的索引。 EnumAdapters1 接著會傳回其他具有輸出的介面卡。 EnumAdapters1 最後會傳回沒有輸出的配接器。
範例
列舉配接器
下列程式碼範例示範如何使用 EnumAdapters1 方法來列舉配接器。
UINT i = 0;
IDXGIAdapter1 * pAdapter;
std::vector <IDXGIAdapter1*> vAdapters;
while(pFactory->EnumAdapters1(i, &pAdapter) != DXGI_ERROR_NOT_FOUND)
{
vAdapters.push_back(pAdapter);
++i;
}
需求
| 最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | dxgi.h |
| 程式庫 | DXGI.lib |