DXGKDDI_VIDPN_RELEASETARGETMODESET 콜백 함수(d3dkmddi.h)

pfnReleaseTargetModeSet 함수는 대상 모드 집합 개체에 대한 핸들을 해제합니다.

구문

DXGKDDI_VIDPN_RELEASETARGETMODESET DxgkddiVidpnReleasetargetmodeset;

NTSTATUS DxgkddiVidpnReleasetargetmodeset(
  [in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet
)
{...}

매개 변수

[in] hVidPn

대상 모드 집합 개체를 포함하는 VidPN 개체에 대한 핸들입니다. VidPN 관리자는 이전에 DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn 또는 DxgkDdiRecommendFunctionalVidPn을 호출하여 디스플레이 미니포트 드라이버에 이 핸들을 제공했습니다.

[in] hVidPnTargetModeSet

해제할 핸들입니다.

반환 값

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

반환 코드 설명
STATUS_SUCCESS 함수가 성공했습니다.
STATUS_GRAPHICS_INVALID_VIDPN hVidPn에 제공된 핸들이 잘못되었습니다.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET hVidPnTargetModeSet에 제공된 핸들이 잘못되었습니다.
STATUS_GRAPHICS_RESOURCES_NOT_RELATED hVidPn으로 식별되는 VidPN에는 hVidPnTargetModeSet로 식별되는 대상 모드 집합이 포함되어 있지 않습니다.

설명

pfnAcquireTargetModeSet을 호출하여 얻은 핸들 사용을 마쳤으면 pfnReleaseTargetModeSet을 호출하여 핸들을 해제해야 합니다.

pfnCreateNewTargetModeSet을 호출하여 핸들을 가져온 다음 해당 핸들을 pfnAssignTargetModeSet에 전달하는 경우 핸들을 해제할 필요가 없습니다.

pfnCreateNewTargetModeSet을 호출하여 핸들을 가져온 다음 새 소스 모드 집합을 원본에 할당하지 않기로 결정한 경우 pfnReleaseTargetModeSet을 호출하여 새로 얻은 핸들을 해제해야 합니다.

D3DKMDT_HVIDPN 및 D3DKMDT_HVIDPNTARGETMODESET 데이터 형식은 D3dkmdt.h로 정의됩니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
헤더 d3dkmddi.h(D3dkmddi.h 포함)
IRQL PASSIVE_LEVEL

참고 항목

pfnAcquireTargetModeSet

pfnCreateNewTargetModeSet