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 열거형보다 적은 어댑터가 있습니다. 컴퓨팅온리 어댑터는 애플리케이션의 호환성이 손상되지 않도록 기본 열거형에서 제외됩니다. DisplayOnly 어댑터도 기본 열거형에서 제외됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10, 버전 2004 |
| 머리글 | d3dkmthk.h |