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 지점이 요청되는 형식 정보를 보유할 만큼 충분히 큰 버퍼임을 보장합니다.
요구 사항
| 대상 플랫폼 | 데스크톱 |
| 머리글 | ddrawint.h(Winddi.h 포함) |