estrutura D3DDDI_LOCKASYNCFLAGS (d3dumddi.h)
A estrutura D3DDDI_LOCKASYNCFLAGS identifica como bloquear um recurso.
Sintaxe
typedef struct _D3DDDI_LOCKASYNCFLAGS {
union {
struct {
UINT NoOverwrite : 1;
UINT Discard : 1;
UINT RangeValid : 1;
UINT AreaValid : 1;
UINT BoxValid : 1;
UINT NoExistingReferences : 1;
UINT NotifyOnly : 1;
UINT Reserved : 25;
};
UINT Value;
};
} D3DDDI_LOCKASYNCFLAGS;
Membros
NoOverwrite
Um valor UINT que especifica se o recurso bloqueado pode ter dados anexados a ele, mas os dados existentes no recurso não podem ser modificados. Esse membro é usado apenas com bloqueios de buffer de vértice do Microsoft Direct3D.
Definir esse membro é equivalente a definir o primeiro bit do membro Value de 32 bits (0x00000001).
Discard
Um valor UINT que especifica se todo o recurso bloqueado é modificado. Se esse valor for definido, como o conteúdo existente pode ser descartado, o conteúdo não exigirá nenhum processamento preliminar.
Definir esse membro é equivalente a definir o segundo bit do membro Value de 32 bits (0x00000002).
RangeValid
Um valor UINT que especifica se o recurso bloqueado é linear.
Definir esse membro é equivalente a definir o terceiro bit do membro Value de 32 bits (0x00000004).
AreaValid
Um valor UINT que especifica se o recurso bloqueado é uma superfície.
Definir esse membro é equivalente a definir o quarto bit do membro Value de 32 bits (0x00000008).
BoxValid
Um valor UINT que especifica se o recurso bloqueado é um volume.
Definir esse membro é equivalente a definir o quinto bit do membro Value de 32 bits (0x00000010).
NoExistingReferences
Um valor UINT que especifica se o runtime do Microsoft Direct3D tem referências enfileiradas para o recurso a ser bloqueado. Se NoExistingReferences estiver definido, o driver determinará que nenhuma referência interna enfileirada ao recurso está disponível. Em seguida, o driver pode definir o sinalizador de campo de bit NoExistingReferences da estrutura D3DDDICB_LOCK quando o driver chama a função pfnLockCb para executar uma operação de descarte de bloqueio.
Definir esse membro é equivalente a definir o sexto bit do membro Value de 32 bits (0x00000020).
NotifyOnly
Um valor UINT que especifica se a chamada de bloqueio é somente para notificação. O runtime do Direct3D define NotifyOnly como TRUE quando bloqueia superfícies de memória do sistema alocadas por runtime. Nessa situação, o runtime ignora o ponteiro que o driver retorna no membro pSurfData da estrutura D3DDDIARG_LOCKASYNC .
Definir esse membro é equivalente a definir o sétimo bit do membro Value de 32 bits (0x00000040).
Reserved
Esse membro é reservado e deve ser definido como zero. Definir esse membro como zero é equivalente a definir os 25 bits restantes (0xFFFFFF80) do membro Value de 32 bits como zeros.
Value
Um membro na união contido em D3DDDI_LOCKASYNCFLAGS que pode conter um valor de 32 bits que identifica como bloquear um recurso.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |