D3DDDIARG_LOCK構造体 (d3dumddi.h)
D3DDDIARG_LOCK構造体は、ロックするリソースまたはリソース内のサーフェスを記述します。
構文
typedef struct _D3DDDIARG_LOCK {
[in] HANDLE hResource;
[in] UINT SubResourceIndex;
union {
[in] D3DDDIRANGE Range;
[in] RECT Area;
[in] D3DDDIBOX Box;
};
[out] VOID *pSurfData;
[out] UINT Pitch;
[out] UINT SlicePitch;
[in] D3DDDI_LOCKFLAGS Flags;
} D3DDDIARG_LOCK;
メンバーズ
[in] hResource
ロックするリソースへのハンドル。
[in] SubResourceIndex
リソースへの 0 から始まるインデックス。hResource で指定ハンドルによって指定されます。 このインデックスは、ロックするサブリソースまたはサーフェスを示します。
[in] Range
ロックする線形リソースのサブ範囲を記述するD3DDDIRANGE構造体。
[in] Area
RECT ロックするサーフェスのサブレクトを記述する構造体です。
[in] Box
ロックするボリュームのサブボリュームを記述するD3DDDIBOX構造体。
[out] pSurfData
ロックされたリソースのメモリ領域へのポインター。 ユーザー モード ディスプレイ ドライバーの Lock 関数は、このポインターを Microsoft Direct3D ランタイムに返します。
[out] Pitch
ロックされたサーフェスのピッチ (バイト単位)。 ユーザー モード ディスプレイ ドライバーの Lock 関数は、このピッチ値を Direct3D ランタイムに返します。
[out] SlicePitch
ロックされたサーフェスのスライス ピッチ (バイト単位)。 ユーザー モード ディスプレイ ドライバーの Lock 関数は、このスライス ピッチ値を Direct3D ランタイムに返します。
[in] Flags
ビット フィールド フラグでリソースをロックする方法を示す D3DDDI_LOCKFLAGS 構造体。 一部のフラグは、他のフラグと相互に排他的であることに注意してください。 詳細については、次の「解説」セクションを参照してください。
備考
Flags メンバーによって指定される構造体のメンバーは、次の規則に従う必要があります。
- ReadOnly と WriteOnly ビット フィールド フラグ 同時に設定することはできません。
- NoOverwrite ビット フィールド フラグは、Discard ビット フィールド フラグと同時に設定することはできません。
- RangeValid、AreaValid、および BoxValid ビット フィールド フラグは、いつでも設定する必要があります。
- ReadOnly ビット フィールド フラグは、Discard ビット フィールド フラグと同時に設定することはできません。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | d3dumddi.h (D3dumddi.h を含む) |