D3DKMTEnumAdapters2 함수(d3dkmthk.h)
D3DKMTEnumAdapters2 함수는 시스템의 모든 그래픽 및 디스플레이 어댑터를 열거하기 위한 정보를 제공합니다.
통사론
NTSTATUS D3DKMTEnumAdapters2(
const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);
매개 변수
unnamedParam1
[in, out] 시스템의 어댑터에 대한 정보를 제공할 D3DKMT_ENUMADAPTERS2 구조체에 대한 포인터입니다. 비고를 참조하세요.
반환 값
D3DKMTEnumAdapters2 성공 시 STATUS_SUCCESS 반환하거나 다음 중 하나와 같은 오류를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
| STATUS_BUFFER_TOO_SMALL | 제공된 배열이 너무 작아서 모든 어댑터를 받을 수 없습니다. |
| STATUS_INVALID_PARAMETER | pAdapters NULL이거나 잘못된 메모리 영역입니다. |
| STATUS_NO_MEMORY | 작업을 충족하기 위해 메모리를 할당할 수 없습니다. |
발언
입력에서
- pAdapters NULL이 아닌 경우 NumAdapterspAdapters 배열에 반환된 어댑터 수가 포함됩니다.
- pAdapters NULL인 경우 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 |