PFND3DKMT_ENUMADAPTERS3 콜백 함수(d3dkmthk.h)

아티클
02/26/2024

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 열거형보다 적은 어댑터가 있습니다. 컴퓨팅온리 어댑터는 애플리케이션의 호환성이 손상되지 않도록 기본 열거형에서 제외됩니다. DisplayOnly 어댑터도 기본 열거형에서 제외됩니다.