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 a 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 de bloqueio de 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.
Observações
Os membros da estrutura especificada pelo Flags membro devem seguir as seguintes regras:
- O ReadOnly e os sinalizadores writeonly de campo de bit não devem ser definidos simultaneamente.
- O sinalizador noOverwrite campo de bits não deve ser definido simultaneamente com o sinalizador Descartar campo de bits.
- Apenas um dos RangeValid, AreaValid e sinalizadores de campo de bits do BoxValid devem ser definidos a qualquer momento.
- O sinalizador de campo de bits ReadOnly não deve ser definido simultaneamente com o sinalizador de Descartar campo de bits.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |