estrutura D3DDDI_LOCKFLAGS (d3dumddi.h)

A estrutura D3DDDI_LOCKFLAGS identifica como bloquear um recurso.

Sintaxe

typedef struct _D3DDDI_LOCKFLAGS {
  union {
    struct {
      UINT ReadOnly : 1;
      UINT WriteOnly : 1;
      UINT NoOverwrite : 1;
      UINT Discard : 1;
      UINT RangeValid : 1;
      UINT AreaValid : 1;
      UINT BoxValid : 1;
      UINT NotifyOnly : 1;
      UINT MightDrawFromLocked : 1;
      UINT DoNotWait : 1;
      UINT Reserved : 22;
    };
    UINT Value;
  };
} D3DDDI_LOCKFLAGS;

Membros

ReadOnly

Um valor UINT que especifica se o recurso bloqueado só pode ser lido. Definir esse membro é equivalente a definir o primeiro bit do membro Value de 32 bits (0x00000001).

WriteOnly

Um valor UINT que especifica se o recurso bloqueado só pode ser gravado. Definir esse membro é equivalente a definir o segundo bit do membro Value de 32 bits (0x00000002).

NoOverwrite

Um valor UINT que especifica se o recurso bloqueado pode ter dados acrescentados a ele, mas os dados existentes no recurso não podem ser modificados. Esse membro é usado somente com bloqueios de buffer de vértice Direct3D.

Definir esse membro é equivalente a definir o terceiro bit do membro Value de 32 bits (0x00000004).

Discard

Um valor UINT que especifica se todo o recurso bloqueado é modificado. Portanto, como o conteúdo existente pode ser descartado, eles não exigem processamento preliminar.

Definir esse membro é equivalente a definir o quarto bit do membro Value de 32 bits (0x00000008).

RangeValid

Um valor UINT que especifica se o recurso bloqueado é linear.

Definir esse membro é equivalente a definir o quinto bit do membro Value de 32 bits (0x00000010).

AreaValid

Um valor UINT que especifica se o recurso bloqueado é uma superfície.

Definir esse membro é equivalente a definir o sexto bit do membro Value de 32 bits (0x00000020).

BoxValid

Um valor UINT que especifica se o recurso bloqueado é um volume.

Definir esse membro é equivalente a definir o sétimo bit do membro Value de 32 bits (0x00000040).

NotifyOnly

Um valor UINT que especifica se a chamada de bloqueio é somente para notificação.

Definir esse membro é equivalente a definir o oitavo bit do membro Value de 32 bits (0x00000080).

MightDrawFromLocked

Um valor UINT que especifica se o driver é possivelmente solicitado a desenhar de um buffer de vértice, mesmo se o buffer de vértice estiver bloqueado pelo runtime do Direct3D. MightDrawFromLocked não garante que o driver receberá chamadas para suas funções DrawIndexedPrimitive, DrawIndexedPrimitive2, DrawPrimitive e DrawPrimitive2 após a chamada para Lock. MightDrawFromLocked é definido apenas em buffers de vértice que foram criados com o sinalizador de campo de bits MightDrawFromLocked definido no membro Flags da estrutura D3DDDIARG_CREATERESOURCE durante o tempo de criação.

Definir esse membro é equivalente a definir o nono bit do membro Value de 32 bits (0x00000100).

DoNotWait

Um valor UINT que especifica se o driver de exibição do modo de usuário deve aguardar até que o recurso fique ocioso. Definir DoNotWait indica que o driver de exibição do modo de usuário não deve esperar que o recurso fique ocioso.

Definir esse membro é equivalente a definir o décimo bit do membro Value de 32 bits (0x00000200).

Reserved

Esse membro é reservado e deve ser definido como zero. Definir esse membro como zero é equivalente a definir os 22 bits restantes (0xFFFFFC00) do membro Value de 32 bits como zeros.

Value

Um membro na união contida em D3DDDI_LOCKFLAGS 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)

Confira também

D3DDDIARG_LOCK