DD_UPDATEVPORTDATA 構造体 (ddrawint.h)
DD_UPDATEVPORTDATA構造体には、 ビデオ ポート拡張機能 (VPE) オブジェクトの開始、停止、変更に必要な情報が含まれています。
構文
typedef struct _DD_UPDATEVPORTDATA {
PDD_DIRECTDRAW_LOCAL lpDD;
PDD_VIDEOPORT_LOCAL lpVideoPort;
PDD_SURFACE_INT *lplpDDSurface;
PDD_SURFACE_INT *lplpDDVBISurface;
PDD_VIDEOPORTINFO lpVideoInfo;
DWORD dwFlags;
DWORD dwNumAutoflip;
DWORD dwNumVBIAutoflip;
HRESULT ddRVal;
VOID *UpdateVideoPort;
} *PDD_UPDATEVPORTDATA, DD_UPDATEVPORTDATA;
メンバー
lpDD
現在の Microsoft DirectDraw プロセスにのみ関連する DD_DIRECTDRAW_LOCAL 構造体を指します。
lpVideoPort
この VPE オブジェクトを表す DD_VIDEOPORT_LOCAL 構造体を指します。
lplpDDSurface
通常のビデオ サーフェスを表 すDD_SURFACE_INT 構造体の配列を指します。 このメンバーは NULL にすることができます。
lplpDDVBISurface
VBI サーフェスを表すDD_SURFACE_INT構造体の配列を指します。 このメンバーは NULL にすることができます。
lpVideoInfo
VPE オブジェクトがビデオ データをサーフェスに転送する方法を説明する DDVIDEOPORTINFO 構造体を指します。 dwFlags がDDRAWI_VPORTSTOPされている場合、このメンバーは NULL にすることができます。
dwFlags
VPE オブジェクトによって実行されるアクションを示します。 このメンバーは、次のいずれかの値である必要があります。
| フラグ | 説明 |
|---|---|
| DDRAWI_VPORTSTART | ドライバーは、VPE オブジェクトを介してデータのフローを開始する必要があります。 |
| DDRAWI_VPORTSTOP | ドライバーは、VPE オブジェクトを介したデータのフローを停止する必要があります。 |
| DDRAWI_VPORTUPDATE | DdVideoPortUpdate は、lpVideoInfo が指す DDVIDEOPORTINFO 構造体の dwVPFlags メンバー内の新しいフラグ セットで呼び出されました。 ドライバーは、新しいフラグに従って VPE オブジェクトを介してデータのフローを変更する必要があります。 |
dwNumAutoflip
lplpDDSurface がポイントするリスト内のサーフェスの数を指定します。 このメンバーが 1 より大きい場合、 lplpDDSurface は、オートフリップに対応するサーフェス構造の配列です。
dwNumVBIAutoflip
lplpDDVBISurface がポイントするリスト内のサーフェスの数を指定します。 このメンバーが 1 より大きい場合、 lplpDDVBISurface は VBI データの自動フラグに対応するサーフェス構造の配列です。
ddRVal
ドライバーが DdVideoPortUpdate コールバックの戻り値を書き込む場所を指定します。 DD_OKのリターン コードは成功を示します。 詳細については、「 DirectDraw の戻り値」を参照してください。
UpdateVideoPort
DirectDraw API によって使用され、ドライバーで入力しないでください。
要件
| 要件 | 値 |
|---|---|
| Header | ddrawint.h (Winddi.h を含む) |