다음을 통해 공유

IDXGIAdapter::EnumOutputs 메서드(dxgi.h)

  • 아티클

어댑터(비디오 카드) 출력을 열거합니다.

구문

HRESULT EnumOutputs(
        UINT        Output,
  [out] IDXGIOutput **ppOutput
);

매개 변수

Output

형식: UINT

출력의 인덱스입니다.

[out] ppOutput

형식: IDXGIOutput**

Output 매개 변수로 지정된 위치에 있는 IDXGIOutput 인터페이스에 대한 포인터의 주소입니다.

반환 값

형식: HRESULT

성공 또는 실패를 나타내는 코드입니다( DXGI_ERROR 참조). 인덱스가 출력 수보다 크면 DXGI_ERROR_NOT_FOUND 반환됩니다.

어댑터가 D3D_DRIVER_TYPE_WARP 사용하여 만든 디바이스에서 온 경우 어댑터에 출력이 없으므로 DXGI_ERROR_NOT_FOUND 반환됩니다.

설명

참고 세션 0 프로세스에서 이 API를 호출하면 DXGI_ERROR_NOT_CURRENTLY_AVAILABLE 반환됩니다.
 
EnumOutputs 메서드가 성공하고 ppOutput 매개 변수를 출력 인터페이스에 대한 포인터의 주소로 채우면 EnumOutputs는 출력 인터페이스의 참조 횟수를 증가합니다. 메모리 누수를 방지하려면 출력 인터페이스 사용을 마치면 Release 메서드를 호출하여 참조 수를 감소합니다.

EnumOutputs는 먼저 데스크톱 주 데이터베이스가 표시되는 출력을 반환합니다. 이 출력은 인덱스 0에 해당합니다. 그런 다음 EnumOutputs는 다른 출력을 반환합니다.

예제

출력 열거

다음은 EnumOutputs 를 사용하여 어댑터의 모든 출력을 열거하는 방법의 예입니다.


UINT i = 0;
IDXGIOutput * pOutput;
std::vector<IDXGIOutput*> vOutputs;
while(pAdapter->EnumOutputs(i, &pOutput) != DXGI_ERROR_NOT_FOUND)
{
    vOutputs.push_back(pOutput);
    ++i;
}

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 dxgi.h
라이브러리 DXGI.lib

추가 정보

DXGI 인터페이스

IDXGIAdapter