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

另請參閱

DXGI 介面

IDXGIFactory1