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 |