PDD_VPORTCB_GETVPORTCONNECT

DdVideoPortGetConnectInfo コールバック関数は、指定された VPE オブジェクトがサポートする接続を返します。

DdVideoPortGetConnectInfo は、次のいずれかのコールバックコードを返します。

DdVideoPortGetConnectInfo は、VPE をサポートする DirectDraw ドライバーで実装する必要があります。

DirectDraw は、指定された VPE オブジェクトがサポートする接続の数と、各接続の特性を取得するために DdVideoPortGetConnectInfo を呼び出します。DdVideoPortGetConnectInfo は、指定された VPE オブジェクトに対して 2 回呼び出されます。

• 1 回目の呼び出しでは、lpGetConnect が指す DD_GETVPORTCONNECTDATA 構造体の lpConnect メンバーは NULL です。ドライバーは、VPE オブジェクトがサポートする接続の数を DD_GETVPORTCONNECTDATA の dwNumEntries メンバーに書き込む必要があります。復帰後、DirectDraw はこの数の DDVIDEOPORTCONNECT 構造体を割り当て、2 回目の DdVideoPortGetConnectInfo の呼び出しで渡します。
• 2 回目の呼び出しでは、lpConnect は割り当てられた DDVIDEOPORTCONNECT 構造体の配列を指します。ドライバーは、VPE オブジェクトがサポートする各接続を記述するように、それぞれの構造体を設定する必要があります。また、ドライバーはサポートする接続の数を dwNumEntries に返す必要があります。なお、lpConnect が指すバッファーは、要求された接続情報を格納するのに十分な大きさであることが保証されています。