DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO 콜백 함수(d3dkmddi.h)

pfnCreateNewModeInfo 함수는 pfnAddMode호출하기 전에 디스플레이 미니포트 드라이버가 채우는 D3DKMDT_VIDPN_TARGET_MODE 구조에 대한 포인터를 반환합니다.

통사론

DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO DxgkddiVidpntargetmodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_TARGET_MODE ppNewVidPnTargetModeInfo
)
{...}

매개 변수

[in] hVidPnTargetModeSet

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

[out] ppNewVidPnTargetModeInfo

VidPN 관리자가 할당한 D3DKMDT_VIDPN_TARGET_MODE 구조체에 대한 포인터를 받는 변수에 대한 포인터입니다.

반환 값

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

반환 코드	묘사
STATUS_SUCCESS	함수가 성공했습니다.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	hVidPnTargetModeSet에 제공된 핸들이 잘못되었습니다.

발언

pfnCreateNewModeInfo 함수는 D3DKMDT_VIDPN_TARGET_MODE 구조를 할당하고 ID 멤버를 새로 생성된 식별자에 설정합니다.

D3DKMDT_VIDPN_TARGET_MODE 구조를 얻기 위해 pfnCreateNewModeInfo 호출한 후에는 다음 중 하나를 수행해야 하지만 둘 다 수행하지는 않아야 합니다.

• 구조체의 Info 멤버를 채우고 구조를 pfnAddMode 전달합니다.
• pfnReleaseModeInfo호출하여 구조를 해제합니다.

D3DKMDT_VIDPN_TARGET_MODE 구조를 채울 때 pfnCreateNewModeInfo 생성되고 설정된 ID 멤버를 덮어쓸 수 있습니다. 그러나 D3DKMDT_VIDPN_TARGET_MODE 구조체의 ID 멤버를 덮어쓰는 경우 pfnCreateNewModeInfo가져온 모든 D3DKMDT_VIDPN_TARGET_MODE 구조체의 ID 멤버를 덮어써야 합니다. ID 멤버를 덮어쓸 특정 이유가 없는 경우(예: 사용자 고유의 번호 매기기 체계를 사용하여 대상 모드 추적) pfnCreateNewModeInfo 설정된 대로 유지해야 합니다.

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista
대상 플랫폼	바탕 화면
헤더	d3dkmddi.h(D3dkmddi.h 포함)
IRQL	PASSIVE_LEVEL

참고 항목

D3DKMDT_VIDPN_TARGET_MODE

pfnAddMode

pfnReleaseModeInfo