PDD_VPORTCB_GETVPORTCONNECT 콜백 함수(ddrawint.h)
DdVideoPortGetConnectInfo 콜백 함수는 지정된 VPE 개체에서 지원하는 연결을 반환합니다.
구문
PDD_VPORTCB_GETVPORTCONNECT PddVportcbGetvportconnect;
DWORD PddVportcbGetvportconnect(
PDD_GETVPORTCONNECTDATA unnamedParam1
)
{...}
매개 변수
unnamedParam1
드라이버가 VPE 개체 연결 데이터를 반환하는 데 필요한 정보를 포함하는 DD_GETVPORTCONNECTDATA 구조를 가리킵니다.
반환 값
DdVideoPortGetConnectInfo 는 다음 콜백 코드 중 하나를 반환합니다.
설명
DdVideoPortGetConnectInfo 는 VPE를 지원하는 DirectDraw 드라이버에서 구현되어야 합니다.
DirectDraw는 DdVideoPortGetConnectInfo 를 호출하여 지정된 VPE 개체에서 지원하는 연결 수와 각 연결의 특성을 가져옵니다. DdVideoPortGetConnectInfo 는 지정된 VPE 개체에 대해 두 번 호출됩니다.
- 첫 번째 호출에서 lpGetConnect 에서 DD_GETVPORTCONNECTDATA 구조체의 lpConnect 멤버는 NULL입니다. 드라이버는 VPE 개체가 DD_GETVPORTCONNECTDATA dwNumEntries 멤버에서 지원하는 연결 수를 작성해야 합니다. 반환 시 DirectDraw는 DdVideoPortGetConnectInfo에 대한 두 번째 호출을 전달하기 위해 이 수의 DDVIDEOPORTCONNECT 구조를 할당합니다.
- 두 번째 호출에서 lpConnect 는 할당된 DDVIDEOPORTCONNECT 구조체의 배열을 가리킵니다. 드라이버는 VPE 개체가 지원하는 각 연결을 설명하기 위해 각 구조를 채워야 합니다. 또한 드라이버는 dwNumEntries에서 지원되는 연결 수를 반환해야 합니다. 드라이버는 lpConnect 지점이 요청되는 연결 정보를 보유할 만큼 충분히 큰 버퍼임을 보장합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | ddrawint.h(Winddi.h 포함) |