DXGKDDI_VIDPNSOURCEMODESET_ADDMODE 콜백 함수(d3dkmddi.h)

  • 아티클

pfnAddMode 함수는 지정된 VidPN 소스 모드 집합 개체에 VidPN 소스 모드를 추가합니다.

구문

DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;

NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

매개 변수

[in] hVidPnSourceModeSet

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

[in] pVidPnSourceModeInfo

소스 모드를 설명하는 D3DKMDT_VIDPN_SOURCE_MODE 구조체에 대한 포인터입니다. 디스플레이 미니포트 드라이버는 이전에 pfnCreateNewModeInfo를 호출하여 이 구조를 얻었습니다.

반환 값

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

반환 코드 설명
STATUS_SUCCESS 함수가 성공했습니다.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET hVidPnSourceModeSet에 제공된 핸들이 잘못되었습니다.

설명

소스 모드 집합에 모드를 추가하기 위해 디스플레이 미니포트 드라이버는 다음 단계를 수행합니다.

pfnCreateNewModeInfo를 호출하여 D3DKMDT_VIDPN_SOURCE_MODE 구조체에 대한 포인터를 가져옵니다. pnfCreateNewModeInfo 함수는 구조를 할당하고, ID 멤버를 새로 생성된 소스 모드 식별자로 채우고, Type 멤버를 D3DKMDT_RMT_UNINITIALIZED 설정합니다.

모드의 형식 및 형식을 포함하여 모드에 대한 정보로 D3DKMDT_VIDPN_SOURCE_MODE 구조체( ID 멤버 제외)를 채웁니다.

pfnAddMode를 호출하여 모드를 소스 모드 집합에 추가합니다.

VidPN 관리자는 pfnCreateNewModeInfo를 호출할 때 D3DKMDT_VIDPN_SOURCE_MODE 구조를 할당합니다. 해당 구조체에서 설명하는 모드를 소스 모드 집합에 추가하는 경우 구조를 명시적으로 해제할 필요가 없습니다. pfnAddMode 가 릴리스합니다.

pfnCreateNewModeInfo를 호출하여 D3DKMDT_VIDPN_SOURCE_MODE 구조를 가져온 다음 해당 모드를 소스 모드 집합에 추가하지 않기로 결정한 경우 pfnReleaseModeInfo를 호출하여 구조를 명시적으로 해제해야 합니다.

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

요구 사항

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

추가 정보

D3DKMDT_VIDPN_SOURCE_MODE

pfnCreateNewModeInfo

pfnReleaseModeInfo