estrutura D3DDDIARG_LOCK (d3dumddi.h)

A estrutura D3DDDIARG_LOCK descreve um recurso ou uma superfície dentro do recurso a ser bloqueado.

Sintaxe

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;

Membros

[in] hResource

Um identificador para o recurso a ser bloqueado.

[in] SubResourceIndex

O índice baseado em zero no recurso, que é especificado pelo identificador especificado por hResource. Esse índice indica a sub-fonte ou superfície a ser bloqueada.

[in] Range

Uma estrutura D3DDDIRANGE que descreve o subconjunto do recurso linear a ser bloqueado.

[in] Area

Uma estrutura RECT que descreve o subrectangle da superfície a ser bloqueada.

[in] Box

Uma estrutura D3DDDIBOX que descreve o subvolume do volume a ser bloqueado.

[out] pSurfData

Um ponteiro para a região de memória do recurso que foi bloqueado. A função Lock do driver de exibição do modo de usuário retorna esse ponteiro para o runtime do Microsoft Direct3D.

[out] Pitch

O tom, em bytes, da superfície que estava bloqueada. A função Lock do driver de exibição do modo de usuário retorna esse valor de pitch para o runtime do Direct3D.

[out] SlicePitch

O tom de fatia, em bytes, da superfície que estava bloqueada. A função Lock do driver de exibição do modo de usuário retorna esse valor de pitch de fatia para o runtime do Direct3D.

[in] Flags

Uma estrutura D3DDDI_LOCKFLAGS que indica, em sinalizadores de campo de bit, como bloquear o recurso. Observe que alguns sinalizadores são mutuamente exclusivos com outros sinalizadores. Para obter mais informações, consulte a seção Comentários a seguir.

Comentários

Os membros da estrutura especificada pelo membro Flags devem seguir as seguintes regras:

• Os sinalizadores de campo de bit ReadOnly e WriteOnly não devem ser definidos simultaneamente.
• O sinalizador de campo de bits NoOverwrite não deve ser definido simultaneamente com o sinalizador Descartar campo de bits.
• Apenas um dos sinalizadores de campo de bit RangeValid, AreaValid e BoxValid deve ser definido a qualquer momento.
• O sinalizador de campo de bit ReadOnly não deve ser definido simultaneamente com o sinalizador Descartar campo de bits.

Requisitos

Confira também

D3DDDI_LOCKFLAGS

Bloquear