PDD_VPORTCB_GETOUTPUTFORMATS 콜백 함수(ddrawint.h)
DdVideoPortGetOutputFormats 콜백 함수는 VPE 개체가 지원하는 출력 형식을 결정합니다.
구문
PDD_VPORTCB_GETOUTPUTFORMATS PddVportcbGetoutputformats;
DWORD PddVportcbGetoutputformats(
PDD_GETVPORTOUTPUTFORMATDATA unnamedParam1
)
{...}
매개 변수
unnamedParam1
드라이버가 VPE 개체에서 지원하는 출력 형식을 반환하는 데 필요한 정보를 포함하는 DD_GETVPORTOUTPUTFORMATDATA 구조를 가리킵니다.
반환 값
DdVideoPortGetOutputFormats는 다음 콜백 코드 중 하나를 반환합니다.
설명
VPE를 지원하는 DirectDraw 드라이버는 DdVideoPortGetOutputFormats를 구현해야 합니다.
DirectDraw는 DdVideoPortGetOutputFormats 를 호출하여 지정된 VPE 개체에서 지원하는 출력 형식의 수와 각 형식에 대한 설명을 가져옵니다. DdVideoPortGetOutputFormats 는 지정된 VPE 개체에 대해 두 번 호출됩니다.
- 첫 번째 호출에서 lpGetOutputFormats 에서 DD_GETVPORTOUTPUTFORMATDATA 구조체의 lpddpfOutputFormats 멤버는 NULL입니다. 드라이버는 VPE 개체가 DD_GETVPORTOUTPUTFORMATDATA dwNumFormats 멤버에서 지원하는 출력 형식의 수를 작성해야 합니다. 반환 시 DirectDraw는 DdVideoPortGetOutputFormats에 대한 두 번째 호출을 전달하기 위해 이 수의 DDPIXELFORMAT 구조를 할당합니다.
- 두 번째 호출에서 lpddpfOutputFormats는 할당된 DDPIXELFORMAT 구조체의 배열을 가리킵니다. 드라이버는 VPE 개체가 프레임 버퍼에 쓸 수 있는 각 출력 형식에 대한 설명으로 각 구조를 채워야 합니다. 드라이버는 비디오 데이터의 입력 형식에 따라 지원하는 출력 형식만 반환해야 합니다. 또한 드라이버는 dwNumFormats에서 지원되는 출력 형식의 수를 반환해야 합니다. 드라이버는 lpddpfOutputFormats 지점의 버퍼가 요청되는 형식 정보를 보유할 만큼 충분히 크다는 것을 보장합니다.
요구 사항
| 대상 플랫폼 | 데스크톱 |
| 머리글 | ddrawint.h(Winddi.h 포함) |