DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO 콜백 함수(d3dkmddi.h)

pfnAcquirePinnedModeInfo 함수는 지정된 VidPN 대상 모드 집합에서 고정된 모드의 설명자를 반환합니다.

구문

DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO DxgkddiVidpntargetmodesetAcquirepinnedmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetAcquirepinnedmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppPinnedVidPnTargetModeInfo
)
{...}

매개 변수

[in] hVidPnTargetModeSet

VidPN 대상 모드 집합 개체에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DXGK_VIDPN_INTERFACE 인터페이스의 pfnAcquireTargetModeSet 함수를 호출하여 이 핸들을 얻었습니다.

[out] ppPinnedVidPnTargetModeInfo

D3DKMDT_VIDPN_TARGET_MODE 구조체에 대한 포인터를 수신하는 변수에 대한 포인터입니다. 구조체에는 해당 ID 및 비디오 신호 특성을 포함하여 고정 모드에 대한 다양한 정보가 포함됩니다. hVidPnTargetModeSet으로 식별되는 대상 모드 집합에 고정 모드가 없는 경우 이 변수는 NULL 포인터를 받습니다.

반환 값

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

반환 코드	설명
STATUS_SUCCESS	함수는 다음 중 하나를 수행하여 성공했습니다. 1. ppPinnedVidPnTargetModeInfo를 고정된 모드를 설명하는 D3DKMDT_VIDPN_TARGET_MODE 구조체의 주소로 설정합니다. 2. 대상 모드 집합에 고정 모드가 없음을 나타내기 위해 ppPinnedVidPnTargetModeInfo를 NULL로 설정합니다.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	hVidPnTargetModeSet에 제공된 핸들이 잘못되었습니다.

설명

D3DKMDT_VIDPN_TARGET_MODE 구조체 사용을 마치면 pfnReleaseModeInfo를 호출하여 구조를 해제해야 합니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
대상 플랫폼	데스크톱
머리글	d3dkmddi.h(D3dkmddi.h 포함)
IRQL	PASSIVE_LEVEL

추가 정보

D3DKMDT_VIDPN_TARGET_MODE

pfnPinMode

pfnReleaseModeInfo