D3DKMTEnumAdapters2 函式（d3dkmthk.h）

D3DKMTEnumAdapters2 函式會提供在系統上列舉所有圖形和顯示適配卡的資訊。

語法

NTSTATUS D3DKMTEnumAdapters2(
  const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);

unnamedParam1

[in， out]要在其中提供系統上適配卡相關信息之 D3DKMT_ENUMADAPTERS2 結構的指標。請參閱。

D3DKMTEnumAdapters2 在成功或下列其中一個錯誤時傳回STATUS_SUCCESS。

傳回碼	描述
STATUS_BUFFER_TOO_SMALL	提供的陣列太小，無法接收所有配接器。
STATUS_INVALID_PARAMETER	pAdapters 為 NULL，否則為無效的記憶體區域。
STATUS_NO_MEMORY	記憶體無法配置以滿足作業。

在輸入時，NumAdapters 會指定 pAdapters 指向的空數組中可以傳回多少個適配卡。傳回時，如果 D3DKMT_ENUMADAPTERS2 傳回STATUS_SUCCESS：

如果 D3DKMT_ENUMADAPTERS2 傳回錯誤，未定義 NumAdapters。

D3DKMTEnumAdapters2 通常會呼叫兩次：

針對第一次呼叫，請將 pAdapters 設定為 NULL。 D3DKMTEnumAdapters2 會在 NumAdapters中寫入支援的適配卡計數上限。
在第二次呼叫中，將 NumAdapters 設為第一次呼叫中傳回的值，並將 pAdapters 設定為指向 NumAdaptersD3DKMT_ENUMADAPTERS2 結構的陣列。 D3DKMTEnumAdapters2 會填入數位，並傳回它所填入的數位結構（配接器）數目。

一旦 D3DKMTEnumAdapters2 的呼叫端成功收到配接器的列舉，呼叫者有責任管理配接器D3DKMT_HANDLEs的壽命。這些句柄會透過 pAdapters傳回，而且必須使用 D3DKMTCloseAdapter關閉。