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

資源中以零起始的索引，由 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 位字段旗標。
• ReadOnly 位字段旗標不得同時設定為 [捨棄位字段] 旗標。

規格需求

另請參閱

D3DDDI_LOCKFLAGS

鎖定