DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO 콜백 함수(d3dkmddi.h)
pfnAcquireNextModeInfo 함수는 현재 모드가 지정된 경우 지정된 모니터 소스 모드 집합에서 다음 모드의 설명자를 반환합니다.
구문
DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiMonitorsourcemodesetAcquirenextmodeinfo;
NTSTATUS DxgkddiMonitorsourcemodesetAcquirenextmodeinfo(
[in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
[in] IN_CONST_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo,
[out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppNextMonitorSourceModeInfo
)
{...}
매개 변수
[in] hMonitorSourceModeSet
모니터 소스 모드 집합 개체에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 모니터 인터페이스의 pfnAcquireMonitorSourceModeSet 함수를 호출하여 이 핸들을 얻었습니다.
[in] pMonitorSourceModeInfo
현재 모드를 설명하는 D3DKMDT_MONITOR_SOURCE_MODE 구조체에 대한 포인터입니다. 디스플레이 미니포트 드라이버는 이전에 pfnAcquireFirstModeInfo 또는 pfnAcquireNextModeInfo를 호출하여 이 포인터를 얻었습니다.
[out] ppNextMonitorSourceModeInfo
다음 모드를 설명하는 D3DKMDT_MONITOR_SOURCE_MODE 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다.
반환 값
pfnAcquireNextModeInfo 함수는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_SUCCESS | 함수가 성공했습니다. |
| STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET | hMonitorSourceModeSet에 제공된 핸들이 잘못되었습니다. |
설명
D3DKMDT_MONITOR_SOURCE_MODE 구조체 사용을 마치면 pfnReleaseModeInfo를 호출하여 구조를 해제해야 합니다.
pfnAcquireFirstModeInfo를 호출한 다음 pfnAcquireNextModeInfo를 호출하여 특정 모니터 소스 모드 집합 개체에 속하는 모든 모드를 열거할 수 있습니다.
D3DKMDT_HMONITORSOURCEMODESET 데이터 형식은 D3dkmdt.h에 정의되어 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dkmddi.h(D3dkmddi.h 포함) |
| IRQL | PASSIVE_LEVEL |