共用方式為

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 指定之資源的以零起始的索引。 此索引表示要鎖定的子資源或表面。

[in] Flags

D3DDDI_LOCKASYNCFLAGS 結構，指出如何在位字段旗標中鎖定資源。

注意 某些旗標與其他旗標互斥。 如需詳細資訊，請參閱下列一節。
 

[in] Range

如果 RangeValid 位欄位字段旗標是在 旗標 所指定之D3DDDI_LOCKASYNCFLAGS結構中設定，則描述要鎖定之線性資源的子範圍D3DDDIRANGE結構。

[in] Area

如果 AreaValid 位字段旗標設定在 旗標所指定的D3DDDI_LOCKASYNCFLAGS結構中，則描述要鎖定之表面子結構 RECT 結構。

[in] Box

如果 BoxValid 位欄位字段旗標是在 flags 所指定之D3DDDI_LOCKASYNCFLAGS結構中設定，則描述要鎖定之磁碟區的子捲D3DDDIBOX結構。

[out] hCookie

表示已重新命名資源的句柄。 只有當 Discard 位字段旗標是在 旗標 指定的D3DDDI_LOCKASYNCFLAGS結構中設定時，這個句柄才有效。

[out] pSurfData

鎖定之資源的記憶體區域的指標。 使用者模式顯示驅動程式的 LockAsync 函式會將此指標傳回至 Microsoft Direct3D 運行時間。

[out] Pitch

鎖定表面的音調，以位元組為單位。 使用者模式顯示驅動程式的 LockAsync 函式會將這個音調值傳回 Direct3D 執行時間。

[out] SlicePitch

已鎖定之表面的配量間距，以位元組為單位。 使用者模式顯示驅動程式的 LockAsync 函式會將此配量間距值傳回 Direct3D 運行時間。

GpuVirtualAddress

這個成員是保留的，而且應該設定為零。

此成員從 Windows 7 開始提供。

言論

旗標 成員所指定之 D3DDDI_LOCKASYNCFLAGS 結構的成員必須遵守下列規則：

  • NoOverwrite 位欄位字段旗標不得與 捨棄 位字段旗標同時設定。
  • 必須隨時設定 RangeValid、AreaValid和 BoxValid 位欄位字段旗標的其中一個。

要求

要求 價值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows作系統中使用。
標頭 d3dumddi.h （包括 D3dumddi.h）

另請參閱

D3DDDI_LOCKASYNCFLAGS

LockAsync

RECT