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 オブジェクトに対して 2 回呼び出されます。
- 最初の呼び出しでは、 lpGetConnect のDD_GETVPORTCONNECTDATA構造体の lpConnect メンバーは NULL です。 ドライバーは、VPE オブジェクトがサポートする接続の数を、DD_GETVPORTCONNECTDATA の dwNumEntries メンバーに書き込む必要があります。 DirectDraw は、戻り時にこの数の DDVIDEOPORTCONNECT 構造体を割り当てて 、DdVideoPortGetConnectInfo への 2 番目の呼び出しで渡します。
- 2 番目の呼び出しでは、 lpConnect は割り当てられた DDVIDEOPORTCONNECT 構造体の配列を指します。 ドライバーは、VPE オブジェクトがサポートする各接続を記述するために、各構造体を入力する必要があります。 ドライバーは 、dwNumEntries でサポートされている接続の数も返す必要があります。 ドライバーは、 lpConnect が指すバッファーが、要求されている接続情報を保持するのに十分な大きさであることが保証されていることに注意してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | ddrawint.h (Winddi.h を含む) |