DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO 콜백 함수(d3dkmddi.h)

pfnAcquireNextFrequencyRangeInfo 함수는 현재 주파수 범위 설명자를 고려하여 모니터 주파수 범위 집합의 다음 주파수 범위 설명자를 반환합니다.

구문

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_FREQUENCY_RANGE_CONST pMonitorFrequencyRangeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppNextMonitorFrequencyRangeInfo
)
{...}

매개 변수

[in] hMonitorFrequencyRangeSet

모니터 빈도 범위 집합 개체에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 모니터 인터페이스의 pfnGetMonitorFrequencyRangeSet 함수를 호출하여 이 핸들을 얻었습니다.

[in] pMonitorFrequencyRangeInfo

현재 빈도 범위 설명자인 D3DKMDT_MONITOR_FREQUENCY_RANGE 구조체에 대한 포인터입니다. 디스플레이 미니포트 드라이버는 이전에 pfnAcquireFirstFrequencyRangeInfo 또는 pfnAcquireNextFrequencyRangeInfo를 호출하여 이 포인터를 얻었습니다.

[out] ppNextMonitorFrequencyRangeInfo

다음 빈도 범위 설명자인 D3DKMDT_MONITOR_FREQUENCY_RANGE 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다.

반환 값

pfnAcquireNextFrequencyRangeInfo 함수는 다음 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	함수는 다음 빈도 범위 설명자를 성공적으로 반환했습니다.
STATUS_GRAPHICS_DATASET_IS_EMPTY	함수가 성공했지만 집합에 더 이상 빈도 범위 설명자가 없었습니다.
STATUS_INVALID_PARAMETER	잘못된 매개 변수가 제공되었습니다.
STATUS_INVALID_FREQUENCYRANGE	pMonitorFrequencyRangeInfo에 제공된 빈도 범위 설명자가 잘못되었습니다.
STATUS_INVALID_MONITOR_FREQUENCYRANGESET	hMonitorFrequencyRangeSet에 제공된 핸들이 잘못되었습니다.

이 함수는 Ntstatus.h에 정의된 다른 오류 코드를 반환할 수도 있습니다.

설명

D3DKMDT_MONITOR_FREQUENCY_RANGE 구조체 사용을 마치면 pfnReleaseFrequencyRangeInfo를 호출하여 구조를 해제해야 합니다.

pfnAcquireFirstFrequencyRangeInfo를 호출한 다음 pfnAcquireNextFrequencyRangeInfo에 대한 호출 시퀀스를 만들어서 설정된 모니터 빈도 범위의 모든 설명자를 가져올 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
대상 플랫폼	데스크톱
머리글	d3dkmddi.h(D3dkmddi.h 포함)
IRQL	PASSIVE_LEVEL