D3DKMTEnumAdapters3 函式（d3dkmthk.h）

提供在系統上列舉圖形和顯示配接器的資訊。

語法

NTSTATUS D3DKMTEnumAdapters3(
  [in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
);

[in/out] unnamedParam1

D3DKMT_ENUMADAPTERS3 結構。呼叫端會傳入陣列大小和空數位空間。被呼叫者會驗證陣列中有足夠的空間、填入陣列，並傳回使用多少數組。

此函式會傳回NTSTATUS。

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

當 D3DKMT_ENUMADAPTERS3：:p Adapters 為 null 時，D3DKMT_ENUMADAPTERS3：：NumAdapters 會設定為支援的配接器計數上限。被呼叫者通常會叫用方法，首先擷取支援的配接器計數上限。

當被呼叫者成功列舉配接器時，它會負責明確管理配接器D3DKMT_HANDLEs的壽命。這些句柄會透過 pEnumAdapters 傳回給被呼叫者，而且必須使用 D3DKMTCloseAdapter關閉這些句柄。

設定任何D3DKMT_ENUMADAPTERS3：：Filter 旗標仍會列舉適配卡，但 D3DKMTEnumAdapters2 列舉的配接器較少。 ComputeOnly 配接器會排除在預設列舉中，以避免中斷應用程式。 DisplayOnly 配接器也排除在預設列舉外。