共用方式為


PFND3DKMT_ENUMADAPTERS3回呼函式 (d3dkmthk.h)

PFND3DKMT_ENUMADAPTERS3回呼函式會列舉系統上的圖形和顯示配接器。

語法

PFND3DKMT_ENUMADAPTERS3 Pfnd3dkmtEnumadapters3;

NTSTATUS Pfnd3dkmtEnumadapters3(
  [in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
)
{...}

參數

[in/out] unnamedParam1

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

傳回值

此函式會傳回NTSTATUS。

傳回碼 Description
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 旗標仍會列舉配接器,但 PFND3DKMT_ENUMADAPTERS2列舉的 配接器較少。 ComputeOnly 配接器會離開預設列舉,以避免中斷應用程式。 DisplayOnly 配接器也會離開預設列舉。

規格需求

需求
最低支援的用戶端 Windows 10 (版本 2004)
標頭 d3dkmthk.h

另請參閱

D3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter

D3DKMTEnumAdapters3

PFND3DKMT_CLOSEADAPTER

PFND3DKMT_ENUMADAPTERS2