共用方式為


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

另請參閱

DXGI 介面

IDXGIFactory