DDSURFACEDATA 構造体 (dxmini.h)
DDSURFACEDATA 構造体は、カーネル モードミニポート ドライバーへのサーフェスを表すために DirectDraw によって使用されます。
構文
typedef struct _DDSURFACEDATA {
DWORD ddsCaps;
DWORD dwSurfaceOffset;
ULONG_PTR fpLockPtr;
DWORD dwWidth;
DWORD dwHeight;
LONG lPitch;
DWORD dwOverlayFlags;
DWORD dwOverlayOffset;
DWORD dwOverlaySrcWidth;
DWORD dwOverlaySrcHeight;
DWORD dwOverlayDestWidth;
DWORD dwOverlayDestHeight;
DWORD dwVideoPortId;
DWORD dwFormatFlags;
DWORD dwFormatFourCC;
DWORD dwFormatBitCount;
DWORD dwRBitMask;
DWORD dwGBitMask;
DWORD dwBBitMask;
ULONG dwDriverReserved1;
ULONG dwDriverReserved2;
ULONG dwDriverReserved3;
ULONG dwDriverReserved4;
} DDSURFACEDATA, *LPDDSURFACEDATA;
メンバー
ddsCaps
サーフェスの記述に使用される作成機能を含む DDSCAPS 構造体を指します。
dwSurfaceOffset
フレーム バッファーの先頭からサーフェスの先頭までのバイト オフセットを指定します。 このフィールドは、ミニポート ドライバーによってのみ使用されます。
fpLockPtr
サーフェスの始点をポイントします。
dwWidth
サーフェスの幅をピクセル単位で指定します。
dwHeight
サーフェスの高さをピクセル単位で指定します。
lPitch
サーフェスピッチをバイト単位で指定します。
dwOverlayFlags
DdUpdateOverlay によって設定されている現在のユーザー モード DDOVER_Xxx フラグを指定するフラグのセットを示します。 このメンバーは、次のいずれかの値のビットごとの OR です。
| フラグ | 説明 |
|---|---|
| DDOVER_ADDDIRTYRECT | エミュレートされたオーバーレイサーフェスにダーティ四角形を追加します。 |
| DDOVER_ALPHADEST | このオーバーレイのアルファ チャネルとして、ピクセル形式でアルファ情報を使用するか、ターゲット サーフェスにアタッチされているアルファ チャネル サーフェスを使用します。 |
| DDOVER_ALPHADESTCONSTOVERRIDE | このオーバーレイの宛先アルファ チャネルとして、DDOVERLAYFX 構造体の dwAlphaDestConst メンバーを使用します。 DDOVERLAYFX 構造体は ddraw.h で定義されています。 |
| DDOVER_ALPHADESTNEG | アルファ値が大きくなると、ターゲット サーフェスはより透明になります (0 は不透明)。 |
| DDOVER_ALPHADESTSURFACEOVERRIDE | このオーバーレイのアルファ チャネル変換先として、DDOVERLAYFX 構造体の lpDDSAlphaDest メンバー (DirectDraw SDK ドキュメントで定義) を使用します。 |
| DDOVER_ALPHAEDGEBLEND | DDOVERLAYFX 構造体 (DirectDraw SDK ドキュメントで定義) の dwAlphaEdgeBlend メンバーを、カラー キーの色を境界線とするイメージの端のアルファ チャネルとして使用します。 |
| DDOVER_ALPHASRC | このオーバーレイのソース アルファ チャネルとして、ピクセル形式でアルファ情報を使用するか、ソース サーフェスにアタッチされたアルファ チャネル サーフェスを使用します。 |
| DDOVER_ALPHASRCCONSTOVERRIDE | このオーバーレイのソース アルファ チャネルとして、DDOVERLAYFX 構造体 (DirectDraw SDK ドキュメントで定義) の dwAlphaSrcConst メンバーを使用します。 |
| DDOVER_ALPHASRCNEG | アルファ値が大きくなると、ソース サーフェスはより透明になります (0 は不透明)。 |
| DDOVER_ALPHASRCSURFACEOVERRIDE | このオーバーレイのアルファ チャネル ソースとして、DDOVERLAYFX 構造体 (DirectDraw SDK ドキュメントで定義) の lpDDSAlphaSrc メンバーを使用します。 |
| DDOVER_AUTOFLIP | ハードウェア ビデオ ポート VSYNC が発生するたびに、フリップ チェーン内の次のサーフェスに自動的に反転します。 |
| DDOVER_BOB | アーティファクトを発生させることなく、インターレースされたビデオ ストリームの各フィールドを個別に表示します。 |
| DDOVER_BOBHARDWARE | Bob は、ソフトウェアではなくハードウェアを使用して実行されるか、エミュレートされます。 |
| DDOVER_DDFX | オーバーレイ FX フラグを使用して、特殊なオーバーレイ効果を定義します。 |
| DDOVER_HIDE | このオーバーレイをオフにします。 |
| DDOVER_INTERLEAVED | サーフェス メモリは、インターリーブされたフィールドで構成されます。 |
| DDOVER_KEYDEST | ターゲット サーフェスに関連付けられているカラー キーを使用します。 |
| DDOVER_KEYDESTOVERRIDE | DDOVERLAYFX 構造体 (DirectDraw SDK ドキュメントで定義) の dckDestColorkey メンバーを、変換先サーフェスのカラー キーとして使用します。 |
| DDOVER_KEYSRC | ソース サーフェスに関連付けられているカラー キーを使用します。 |
| DDOVER_KEYSRCOVERRIDE | ソース サーフェイスのカラー キーとして、DDOVERLAYFX 構造体の dckSrcColorkey メンバー (DirectDraw SDK ドキュメントで定義) を使用します。 |
| DDOVER_OVERRIDEBOBWEAVE | Bob と織りの決定は、他のインターフェイスでオーバーライドしないでください。 このフラグが設定されている場合、DirectDraw では、カーネル モード ドライバーがカーネル モードのビデオ トランスポート機能を使用して、ハードウェアを bob モードと織りモードに切り替えることを許可しません。 |
| DDOVER_REFRESHALL | エミュレートされたオーバーレイサーフェス上のサーフェス全体を再描画します。 |
| DDOVER_REFRESHDIRTYRECTS | エミュレートされたオーバーレイサーフェス上のすべてのダーティ四角形を再描画します。 |
| DDOVER_SHOW | このオーバーレイをオンにします。 |
dwOverlayOffset
フレーム バッファーの先頭からオーバーレイの先頭までのバイト オフセットを指定します。 このフィールドは、ミニポート ドライバーによってのみ使用されます。
dwOverlaySrcWidth
オーバーレイソースの幅をピクセル単位で指定します。 このフィールドは、ミニポート ドライバーによってのみ使用されます。
dwOverlaySrcHeight
オーバーレイソースの高さをピクセル単位で指定します。 このフィールドは、ミニポート ドライバーによってのみ使用されます。
dwOverlayDestWidth
オーバーレイ先の幅をピクセル単位で指定します。 このフィールドは、ミニポート ドライバーによってのみ使用されます。
dwOverlayDestHeight
オーバーレイ先の高さをピクセル単位で指定します。 このフィールドは、ミニポート ドライバーによってのみ使用されます。
dwVideoPortId
このサーフェスが ビデオ ポート拡張 (VPE) オブジェクトによって供給されている場合、このフィールドは VPE オブジェクトの ID、範囲内の整数 (0 - (ハードウェア ビデオ ポートの最大数 -1 )) を示します。それ以外の場合、このフィールドは -1 です。
dwFormatFlags
ピクセル形式のコントロール フラグのセットを指定します。 このメンバーは、次のいずれかの値のビットごとの OR です。
| フラグ | 説明 |
|---|---|
| DDPF_ALPHA | ピクセル形式は、アルファのみのサーフェスを表します。 |
| DDPF_ALPHAPIXELS | サーフェスには、ピクセル形式のアルファ チャネル情報があります。 |
| DDPF_ALPHAPREMULT | ピクセル内の色成分は、ピクセル内のアルファ値によって事前に乗算されます。 このフラグを設定する場合は、DDPF_ALPHAPIXELS フラグも設定する必要があります。 このフラグが設定されていないが、DDPF_ALPHAPIXELS フラグが設定されている場合、ピクセル形式の色コンポーネントはアルファで事前に乗算されません。 この場合、アルファ ブレンド操作が実行されるときに、色成分にアルファ値を乗算する必要があります。 |
| DDPF_BUMPDUDV | ピクセル形式のバンプ マップ dUdV データは有効です。 |
| DDPF_BUMPLUMINANCE | ピクセル形式の輝度データは有効です。 このフラグは、バンプマップ サーフェスから輝度をぶら下げるときに使用されます。 ピクセルの輝度部分のビットマスクは、DDPIXELFORMAT 構造体の dwBumpLuminanceBitCount メンバーによって示されます。 |
| DDPF_COMPRESSED | サーフェスは、指定された形式のピクセル データを受け入れ、書き込み操作中に圧縮します。 |
| DDPF_FOURCC | FOURCC コードは有効です。 |
| DDPF_LUMINANCE | ピクセル形式の輝度データは有効です。 このフラグは、輝度のみ、または輝度にアルファサーフェスを加えた場合に使用されます。その後、DDPIXELFORMAT 構造体の dwLuminanceBitCount メンバーによってビット深度が示されます。 |
| DDPF_PALETTEINDEXED1 | サーフェスには、1 ビットのカラー インデックスが付きます。 |
| DDPF_PALETTEINDEXED2 | サーフェスには、2 ビットのカラー インデックスが付きます。 |
| DDPF_PALETTEINDEXED4 | サーフェスには 4 ビット カラー インデックスが付きます。 |
| DDPF_PALETTEINDEXED8 | サーフェスには、8 ビットのカラー インデックスが付きます。 |
| DDPF_PALETTEINDEXEDTO8 | サーフェスは、8 ビット パレットにインデックスが付いた 1 ビット、2 ビット、または 4 ビットの色です。 |
| DDPF_RGB | ピクセル形式構造の RGB データは有効です。 |
| DDPF_RGBTOYUV | サーフェスは RGB データを受け入れ、書き込み操作中に YUV データに変換します。 書き込まれるデータの形式は、ピクセル形式構造に含まれます。 DDPF_RGB フラグが設定されます。 |
| DDPF_STENCILBUFFER | サーフェスには、ステンシル情報と Z 情報が含まれています。 |
| DDPF_YUV | ピクセル形式構造の YUV データは有効です。 |
| DDPF_ZBUFFER | ピクセル形式は、z バッファーのみのサーフェスを表します。 |
| DDPF_ZPIXELS | サーフェスは RGBZ 形式です。 |
dwFormatFourCC
FOURCC コードを指定します。
dwFormatBitCount
ピクセルあたりのビット数 (4、8、16、24、または 32) を指定します。
dwRBitMask
赤いビットマスクを指定します。
dwGBitMask
緑色のビットマスクを指定します。
dwBBitMask
青いビットマスクを指定します。
dwDriverReserved1
HAL/ミニポート用に予約済み
dwDriverReserved2
HAL/ミニポート用に予約済み
dwDriverReserved3
HAL/ミニポート用に予約済み
dwDriverReserved4
ミニポート ドライバーで使用するために予約されています。
要件
| Header | dxmini.h (Dxmini.h を含む) |