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 ビット フィールド フラグを、ビット フィールドの破棄フラグと同時に設定することはできません。
- RangeValid、AreaValid、BoxValid のビット フィールド フラグは、いつでも 1 つだけ設定する必要があります。
- ReadOnly ビット フィールド フラグを、ビット フィールドの破棄フラグと同時に設定することはできません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| Header | d3dumddi.h (D3dumddi.h を含む) |