DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH 콜백 함수(d3dkmddi.h)

아티클
05/26/2023

DxgkDdiUpdateActiveVidPnPresentPath 함수는 디스플레이 어댑터에서 현재 활성화된 비디오 현재 경로 중 하나를 업데이트합니다.

구문

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

NTSTATUS DxgkddiUpdateactivevidpnpresentpath(
       IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_UPDATEACTIVEVIDPNPRESENTPATH_CONST pUpdateActiveVidPnPresentPath
)
{...}

매개 변수

hAdapter

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkDdiAddDevice 함수의 MiniportDeviceContext 출력 매개 변수에서 Microsoft DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

[in] pUpdateActiveVidPnPresentPath

하나의 멤버인 D3DKMDT_VIDPN_PRESENT_PATH 구조체를 포함하는 DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH 구조체에 대한 포인터입니다. D3DKMDT_VIDPN_PRESENT_PATH 구조체의 멤버는 경로를 식별하고 경로에 대한 새 설정을 제공합니다. DxgkDdiUpdateActiveVidPnPresentPath 함수는 새 설정에 따라 디스플레이 어댑터의 경로를 프로그래밍해야 합니다.

반환 값

DxgkDdiUpdateActiveVidPnPresentPath는 다음 값 중 하나를 반환합니다.

값	Description
STATUS_SUCCESS	함수가 성공했습니다.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo>로 지정된 경로가 활성 VidPN의 토폴로지에 없습니다.
STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED	경로는 pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.ContentTransformation>으로 지정된 콘텐츠 변환을 지원하지 않습니다. 경로는 pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.GammaRamp>로 지정된 감마 램프를 지원하지 않습니다.

설명

운영 체제는 DxgkDdiUpdateActiveVidPnPresentPath 함수를 호출하여 경로 회전, 제시된 콘텐츠의 기하 도형 변환, 제공된 콘텐츠의 밝기를 조정하는 데 사용되는 감마 램프 등과 같은 비디오 현재 경로의 설정을 제어합니다.

참고 디스플레이 미니포트 드라이버의 DxgkDdiUpdateActiveVidPnPresentPath 함수는 감마 램프를 지원해야 합니다.

Windows 8 시작하여 디스플레이 미니포트 드라이버가 DXGK_DRIVERCAPS 구조체의 SupportSmoothRotation 멤버를 설정하는 경우 DxgkDdiUpdateActiveVidPnPresentPath 함수를 사용하여 어댑터의 경로 회전 업데이트를 지원해야 합니다. 드라이버는 항상 DxgkDdiCommitVidPn 함수를 호출하는 동안 경로 회전을 설정할 수 있어야 합니다.

DxgkDdiUpdateActiveVidPnPresentPath 함수를 페이징 가능으로 만들어야 합니다.