다음을 통해 공유

PDD_VPORTCB_GETINPUTFORMATS 콜백 함수(ddrawint.h)

  • 아티클

DdVideoPortGetInputFormats 콜백 함수는 DirectDraw VPE 개체가 허용할 수 있는 입력 형식을 결정합니다.

구문

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

매개 변수

unnamedParam1

드라이버가 VPE 개체가 허용할 수 있는 입력 형식을 반환하는 데 필요한 정보를 포함하는 DD_GETVPORTINPUTFORMATDATA 구조를 가리킵니다.

반환 값

DdVideoPortGetInputFormats는 다음 콜백 코드 중 하나를 반환합니다.

설명

DdVideoPortGetInputFormats는 VPE를 지원하는 DirectDraw 드라이버에서 구현되어야 합니다.

DirectDraw는 DdVideoPortGetInputFormats 를 호출하여 지정된 VPE 개체에서 지원하는 입력 형식의 수와 각 형식에 대한 설명을 가져옵니다. DdVideoPortGetInputFormats 는 지정된 VPE 개체에 대해 두 번 호출됩니다.

  • 첫 번째 호출에서 lpGetInputFormats에 있는 DD_GETVPORTINPUTFORMATDATA 구조체의 lpddpfFormat 멤버는 NULL입니다. 드라이버는 VPE 개체가 DD_GETVPORTINPUTFORMATDATA dwNumFormats 멤버에서 지원하는 입력 형식의 수를 작성해야 합니다. 반환 시 DirectDraw는 DdVideoPortGetInputFormats에 대한 두 번째 호출을 전달하기 위해 이 수의 DDPIXELFORMAT 구조를 할당합니다.
  • 두 번째 호출에서 lpddpfFormat 은 할당된 DDPIXELFORMAT 구조체의 배열을 가리킵니다. 드라이버는 VPE 개체가 지원하는 각 입력 형식을 설명하기 위해 각 구조를 입력해야 합니다. 또한 드라이버는 dwNumFormats에서 지원되는 입력 형식의 수를 반환해야 합니다. 드라이버는 lpddpfFormat 지점이 요청되는 형식 정보를 보유할 만큼 충분히 큰 버퍼임을 보장합니다.
DD_GETVPORTINPUTFORMATDATA 구조체의 dwFlags 멤버가 DDVPFORMAT_VIDEO만 설정된 경우 드라이버는 일반 비디오 데이터에 대해 지원되는 형식만 반환해야 합니다. dwFlags가 DDVPFORMAT_VBI만 설정된 경우 드라이버는 VBI 데이터에 대해 지원되는 형식만 반환해야 합니다. dwFlags가 두 플래그로 설정된 경우 드라이버는 VPE 개체에서 지원하는 모든 형식을 반환해야 합니다.

요구 사항

   
대상 플랫폼 데스크톱
머리글 ddrawint.h(Winddi.h 포함)

추가 정보

DDPIXELFORMAT

DD_GETVPORTINPUTFORMATDATA