estrutura D3DDDIARG_COPYFLAGS (d3dumddi.h)

  • Artigo

Descreve como lidar com o conteúdo existente de um recurso durante uma operação de cópia ou atualização de uma região dentro desse recurso. Usado pelo WDDM (Modelo de Driver de Exibição do Windows) 1.3 e drivers de exibição do modo de usuário posteriores.

Sintaxe

typedef struct D3DDDIARG_COPYFLAGS {
  union {
    struct {
      UINT NoOverwrite : 1;
      UINT Discard : 1;
      UINT Reserved1 : 22;
      UINT BoxValid : 1;
      UINT Reserved2 : 7;
    };
    UINT Value;
  };
} D3DDDIARG_COPYFLAGS;

Membros

NoOverwrite

Especifica que o chamador garante que a parte da superfície que está sendo gravada com novos dados não esteja sendo referenciada ou acessada por nenhuma operação de renderização anterior. O driver pode aproveitar essa funcionalidade para otimizar o desempenho e o uso de memória.

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

Discard

Especifica que o driver de exibição do modo de usuário pode descartar o conteúdo anterior de todo o recurso. O driver pode aproveitar essa funcionalidade para otimizar o desempenho e o uso de memória.

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

Reserved1

Esse membro é reservado e deve ser definido como zero.

Definir esse membro como zero é equivalente a definir os bits de 3 a 24 (0x00FFFFFC) do membro Value de 32 bits como zeros.

BoxValid

Especifica que uma região de destino do sub-recurso a ser copiado é válida. Quando não definido, todo o sub-recurso deve ser atualizado.

Definir esse membro é equivalente a definir o 25º bit do membro Value de 32 bits (0x01000000).

Reserved2

Esse membro é reservado e deve ser definido como zero.

Definir esse membro como zero é equivalente a definir os bits de 26 a 32 (0xFE000000) do membro Value de 32 bits como zeros.

Value

Um membro na união que D3DDDIARG_COPYFLAGS contém que pode conter um valor de 32 bits que identifica como lidar com o conteúdo existente de um recurso durante uma operação de cópia ou atualização.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1
Servidor mínimo com suporte Windows Server 2012 R2
Cabeçalho d3dumddi.h (inclua D3d10umddi.h)

Confira também

D3DDDIARG_UPDATESUBRESOURCEUP