D3DDDIARG_LOCKASYNC 構造体 (d3dumddi.h)
D3DDDIARG_LOCKASYNC構造は、ロックするリソースまたはリソース内のサーフェスを記述します。
構文
typedef struct _D3DDDIARG_LOCKASYNC {
[in] HANDLE hResource;
[in] UINT SubResourceIndex;
[in] D3DDDI_LOCKASYNCFLAGS Flags;
union {
[in] D3DDDIRANGE Range;
[in] RECT Area;
[in] D3DDDIBOX Box;
};
[out] HANDLE hCookie;
[out] VOID *pSurfData;
[out] UINT Pitch;
[out] UINT SlicePitch;
D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDIARG_LOCKASYNC;
メンバー
[in] hResource
ロックするリソースへのハンドル。
[in] SubResourceIndex
hResource が指定するリソースへの 0 から始まるインデックス。 このインデックスは、ロックするサブリソースまたはサーフェスを示します。
[in] Flags
ビット フィールド フラグでリソースをロックする方法を示すD3DDDI_LOCKASYNCFLAGS構造体。
[in] Range
RangeValid ビット フィールド フラグが Flags で指定されたD3DDDI_LOCKASYNCFLAGS構造体に設定されている場合に、ロックする線形リソースのサブ範囲を記述するD3DDDIRANGE構造体。
[in] Area
AreaValid ビット フィールド フラグが Flags で指定されたD3DDDI_LOCKASYNCFLAGS構造体に設定されている場合に、ロックするサーフェスのサブrectangleを記述する RECT 構造体。
[in] Box
ロックするボリュームのサブボリュームを記述するD3DDDIBOX構造体 。Flags が指定するD3DDDI_LOCKASYNCFLAGS構造体で BoxValid ビット フィールド フラグが設定されている場合。
[out] hCookie
名前が変更されたリソースを表すハンドル。 このハンドルは、Flags が指定するD3DDDI_LOCKASYNCFLAGS構造体で破棄ビット フィールド フラグが設定されている場合にのみ有効です。
[out] pSurfData
ロックされたリソースのメモリ領域へのポインター。 ユーザー モードディスプレイ ドライバーの LockAsync 関数は、このポインターを Microsoft Direct3D ランタイムに返します。
[out] Pitch
ロックされたサーフェスのピッチ (バイト単位)。 ユーザー モードディスプレイ ドライバーの LockAsync 関数は、このピッチ値を Direct3D ランタイムに返します。
[out] SlicePitch
ロックされたサーフェスのスライス ピッチ (バイト単位)。 ユーザー モードディスプレイ ドライバーの LockAsync 関数は、このスライス ピッチ値を Direct3D ランタイムに返します。
GpuVirtualAddress
このメンバーは予約済みであり、0 に設定する必要があります。
このメンバーは、Windows 7 以降で使用できます。
注釈
Flags メンバーが指定するD3DDDI_LOCKASYNCFLAGS構造体のメンバーは、次の規則に従う必要があります。
- NoOverwrite ビット フィールド フラグは、破棄ビット フィールド フラグと同時に設定することはできません。
- RangeValid、AreaValid、および BoxValid ビット フィールド フラグの 1 つだけをいつでも設定する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| Header | d3dumddi.h (D3dumddi.h を含む) |