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