DXGKDDI_VIDPN_ACQUIRESOURCEMODESET 콜백 함수(d3dkmddi.h)

아티클
02/27/2024

pfnAcquireSourceModeSet 함수는 지정된 VidPN 개체에 포함된 특정 소스 모드 집합 개체에 대한 핸들을 반환합니다.

구문

DXGKDDI_VIDPN_ACQUIRESOURCEMODESET DxgkddiVidpnAcquiresourcemodeset;

NTSTATUS DxgkddiVidpnAcquiresourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}

매개 변수

[in] hVidPn

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

[in] VidPnSourceId

VidPN 개체와 연결된 비디오 현재 원본 중 하나를 식별하는 정수입니다.

[out] phVidPnSourceModeSet

요청된 소스 모드 집합 개체에 대한 핸들을 수신하는 변수에 대한 포인터입니다.

[out] ppVidPnSourceModeSetInterface

DXGK_VIDPNSOURCEMODESET_INTERFACE 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다. 구조체에는 디스플레이 미니포트 드라이버가 소스 모드 집합 개체를 검사하고 변경하기 위해 호출할 수 있는 함수에 대한 포인터가 포함되어 있습니다.

반환 값

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

반환 코드	설명
STATUS_SUCCESS	함수가 성공했습니다.
STATUS_GRAPHICS_INVALID_VIDPN	hVidPn에 제공된 핸들이 잘못되었습니다.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE	VidPnSourceId에 제공된 식별자가 잘못되었습니다.

설명

VidPN 원본 식별자는 운영 체제에서 할당됩니다. 디스플레이 미니포트 드라이버에 의해 구현된 DxgkDdiStartDevice는 디스플레이 어댑터에서 지원하는 비디오 현재 원본의 N을 반환합니다. 그런 다음 운영 체제는 식별자 0, 1, 2, ... 를 할당합니다. N - 1.

소스 모드 집합 개체 핸들 사용을 마쳤으면 pfnReleaseSourceModeSet를 호출하여 핸들을 해제해야 합니다. 소스 모드 집합 개체는 참조 횟수가 계산되므로 핸들을 여러 번 획득하는 경우 동일한 횟수만큼 해제해야 합니다.

ppVidPnSourceModeSetInterface에서 반환된 DXGK_VIDPNSOURCEMODESET_INTERFACE 구조체의 수명은 운영 체제에서 소유합니다. 운영 체제는 이 소유권 체계를 사용하여 인터페이스의 클라이언트를 중단하지 않고 런타임에 최신 구현으로 전환할 수 있습니다.

D3DDDI_VIDEO_PRESENT_SOURCE_ID 데이터 형식은 D3dukmdt.h에 정의되어 있습니다.

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