D3DKMTEnumAdapters2 함수(d3dkmthk.h)

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

구문

NTSTATUS D3DKMTEnumAdapters2(
  const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);

unnamedParam1

_Inout_ D3DKMT_ENUMADAPTERS2 * Arg1

호출자는 배열 크기와 빈 배열 공간을 전달합니다. 호출 수신자는 배열에 충분한 공간을 확인하고, 배열을 채우고, 사용된 배열의 양을 다시 전달합니다.

이 함수는 NTSTATUS를 반환합니다.

반환 코드	설명
STATUS_BUFFER_TOO_SMALL	제공된 배열이 너무 작아서 모든 어댑터를 받을 수 없을 때
STATUS_INVALID_PARAMETER	pEnumAdapters가 null이거나 잘못된 메모리 영역인 경우
STATUS_NO_MEMORY	작업을 충족하기 위해 메모리를 할당할 수 없는 경우

D3DKMT_ENUMADAPTERS2::p Adapters가 null이면 D3DKMT_ENUMADAPTERS2::NumAdapters가 지원되는 최대 어댑터 수로 설정됩니다. 호출자는 일반적으로 메서드를 먼저 호출하여 지원되는 최대 어댑터 수를 검색합니다.

호출 수신자가 어댑터를 성공적으로 열거하면 어댑터 D3DKMT_HANDLEs 수명을 명시적으로 관리해야 합니다. 이러한 핸들은 pEnumAdapters를 통해 호출 수신자에게 반환되며 D3DKMTCloseAdapter로 닫혀야 합니다.