D3DKMTEnumAdapters2 함수(d3dkmthk.h)

D3DKMTEnumAdapters2 함수는 시스템의 모든 그래픽 및 디스플레이 어댑터를 열거하기 위한 정보를 제공합니다.

구문

NTSTATUS D3DKMTEnumAdapters2(
  const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);

매개 변수

unnamedParam1

[in, out] 시스템의 어댑터에 대한 정보를 제공할 D3DKMT_ENUMADAPTERS2 구조체에 대한 포인터입니다. 설명 부분을 참조하세요.

반환 값

D3DKMTEnumAdapters2 는 성공 시 STATUS_SUCCESS 반환하거나 다음 중 하나와 같은 오류를 반환합니다.

반환 코드	Description
STATUS_BUFFER_TOO_SMALL	제공된 배열이 너무 작아서 모든 어댑터를 받을 수 없습니다.
STATUS_INVALID_PARAMETER	pAdapters 가 NULL이거나, 그렇지 않으면 잘못된 메모리 영역입니다.
STATUS_NO_MEMORY	작업을 충족하기 위해 메모리를 할당할 수 없습니다.

설명

입력에서 NumAdapters 는 pAdapters 가 가리키는 빈 배열에서 반환할 수 있는 어댑터 수를 지정합니다. 반환할 때 D3DKMT_ENUMADAPTERS2 STATUS_SUCCESS 반환하는 경우:

• pAdapters가 NULL이 아닌 경우 NumAdapters에는 pAdapters 배열에 반환된 어댑터 수가 포함됩니다.
• pAdapters가 NULL인 경우 NumAdapters에는 지원되는 최대 어댑터 수가 포함됩니다.

D3DKMT_ENUMADAPTERS2 오류를 반환하면 NumAdapters가 정의되지 않습니다.

D3DKMTEnumAdapters2 는 일반적으로 두 번 호출됩니다.

• 첫 번째 호출의 경우 pAdapters를 NULL로 설정합니다. D3DKMTEnumAdapters2 는 NumAdapters에서 지원되는 최대 어댑터 수를 작성합니다.

• 두 번째 호출의 경우 NumAdapters 를 첫 번째 호출에서 반환된 값으로 설정하고 pAdapters 를 NumAdaptersD3DKMT_ENUMADAPTERS2 구조체의 배열을 가리키도록 설정합니다. D3DKMTEnumAdapters2 는 배열을 채우고 채워진 배열 구조체(어댑터)의 수를 다시 전달합니다.

D3DKMTEnumAdapters2의 호출자가 어댑터 열거를 성공적으로 받으면 어댑터 D3DKMT_HANDLEs 수명을 관리하는 것은 호출자의 책임입니다. 이러한 핸들은 pAdapters를 통해 반환되며 D3DKMTCloseAdapter로 닫혀야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	Windows
헤더	d3dkmthk.h(D3dkmthk.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll

추가 정보

D3DKMT_ENUMADAPTERS2

PFND3DKMT_ENUMADAPTERS2

D3DKMTCloseAdapter