DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET 콜백 함수(d3dkmddi.h)
pfnGetMonitorDescriptorSet 함수는 지정된 모니터와 연결된 모니터 설명자 집합 개체에 대한 핸들을 반환합니다.
구문
DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET DxgkddiMonitorGetmonitordescriptorset;
NTSTATUS DxgkddiMonitorGetmonitordescriptorset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORDESCRIPTORSET phMonitorDescriptorSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORDESCRIPTORSET_INTERFACE ppMonitorDescriptorSetInterface
)
{...}
매개 변수
[in] hAdapter
디스플레이 어댑터를 식별하는 핸들입니다. Microsoft DirectX 그래픽 커널 하위 시스템은 이전에 DxgkDdiStartDevice 함수의 DxgkInterface 매개 변수에 있는 디스플레이 미니포트 드라이버에 이 핸들을 제공했습니다.
[in] VideoPresentTargetId
디스플레이 어댑터에 있는 비디오 대상 중 하나를 식별하는 정수입니다. 반환된 모니터 설명자 집합 개체에는 이 비디오 현재 대상에 연결된 모니터에 대한 설명자가 포함되어 있습니다.
[out] phMonitorDescriptorSet
모니터 설명자 집합 개체에 대한 핸들을 수신하는 변수에 대한 포인터입니다.
[out] ppMonitorDescriptorSetInterface
DXGK_MONITORDESCRIPTORSET_INTERFACE 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다. 구조체에는 디스플레이 미니포트 드라이버가 모니터 설명자 집합 개체를 검사하고 변경하기 위해 호출할 수 있는 함수에 대한 포인터가 포함되어 있습니다.
반환 값
pfnGetMonitorDescriptorSet 함수는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_SUCCESS | 함수가 성공했습니다. |
| STATUS_INVALID_PARAMETER | 잘못된 매개 변수가 제공되었습니다. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | hAdapter에 제공된 핸들이 잘못되었습니다. |
| STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET | VideoPresentTargetId에 제공된 식별자가 잘못되었습니다. |
| STATUS_GRAPHICS_MONITOR_NOT_CONNECTED | VideoPresentTargetId로 식별된 비디오 현재 대상에 연결된 모니터가 없습니다. |
설명
VidPN 대상 식별자는 디스플레이 미니포트 드라이버에 의해 할당됩니다. 디스플레이 미니포트 드라이버에 의해 구현된 DxgkDdiQueryChildRelations 함수는 각각 식별자를 포함하는 DXGK_CHILD_DESCRIPTOR 구조체의 배열을 반환합니다.
phMonitorDescriptorSet에서 반환된 핸들을 해제할 필요가 없습니다.
이 함수는 Windows 7부터 DXGK_MONITOR_INTERFACE_V2 인터페이스에서도 사용할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dkmddi.h(D3dkmddi.h 포함) |
| IRQL | PASSIVE_LEVEL |