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 を含む)

こちらもご覧ください

D3DDDI_LOCKFLAGS

[Lock] (ロック)