다음을 통해 공유


D3DKMT_ENUMADAPTERS3 구조체(d3dkmthk.h)

D3DKMT_ENUMADAPTERS3 구조체는 시스템의 어댑터에 대한 정보를 제공합니다.

통사론

typedef struct _D3DKMT_ENUMADAPTERS3 {
  [in]     D3DKMT_ENUMADAPTERS_FILTER Filter;
  [in/out] ULONG                      NumAdapters;
  [out]    D3DKMT_ADAPTERINFO         *pAdapters;
} D3DKMT_ENUMADAPTERS3;

회원

[in] Filter

열거형에 대한 필터 플래그가 포함된 D3DKMT_ENUMADAPTERS_FILTER 공용 구조체입니다. 필터 구조체는 다음 값의 비트 OR일 수 있습니다. 자세한 내용은 비고를 참조하세요.

의미
IncludeComputeOnly 설정되면 ComputeOnly 어댑터를 열거합니다.
IncludeDisplayOnly 설정되면 DisplayOnly 어댑터를 열거합니다.
IncludeVirtualGpuOnly 설정되면 GPU-P 어댑터를 열거합니다. 이러한 어댑터는 가상 머신 내에서만 사용됩니다. 드라이버는 호스트 OS에서 열거를 방지하기 위해 이러한 어댑터의 DXGK_DRIVERCAPS::MiscCaps.VirtualGpuOnly 캡을 설정합니다. Windows 11 버전 24H2(WDDM 3.2)부터 사용할 수 있습니다.
예약 예약; 사용하지 마세요.

[in/out] NumAdapters

어댑터 수입니다.

입력에서 NumAdapterspAdapters 배열에서 반환할 수 있는 어댑터 수를 지정합니다. NumAdapters 가능한 반환 값은 다음과 같습니다.

  • pAdapters null이 아닌 경우 반환이 성공하면 NumAdapterspAdapters 배열에 반환된 어댑터 수를 포함합니다.
  • pAdapters null이면 반환이 성공하면 NumAdapters 지원되는 최대 어댑터 수가 포함됩니다.
  • pAdapters null이 아닌 경우 반환에 실패하면 NumAdapters 정의되지 않습니다.

[out] pAdapters

각 어댑터에 대한 정보를 받을 D3DKMT_ADAPTERINFO 구조체의 선택적 배열입니다.

발언

필터플래그가 설정되지 않은 경우에도 어댑터가 열거되지만 D3DKMTEnumAdapters3D3DKMTEnumAdapters2보다 적은 어댑터를 열거합니다. 특히 D3DKMTEnumAdapters3 다음을 수행합니다.

  • 애플리케이션이 중단되지 않도록 ComputeOnly 어댑터를 기본 열거형에서 제외합니다.
  • DisplayOnly 어댑터는 기본 열거형에서 제외합니다.

요구 사항

요구
지원되는 최소 클라이언트 Windows 10 버전 2004
헤더 d3dkmthk.h

참고 항목

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3