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 포함)