struttura D3DDDIARG_COPYFLAGS (d3dumddi.h)

Viene descritto come gestire il contenuto esistente di una risorsa durante un'operazione di copia o aggiornamento di un'area all'interno di tale risorsa. Usato dai driver di visualizzazione Windows Display Driver Model (WDDM) 1.3 e versioni successive.

Sintassi

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;

Members

NoOverwrite

Specifica che il chiamante garantisce che la parte della superficie in cui viene scritto con nuovi dati non venga attualmente fatto riferimento o a cui si accede da qualsiasi operazione di rendering precedente. Il driver può sfruttare questa funzionalità per ottimizzare le prestazioni e l'utilizzo della memoria.

L'impostazione di questo membro equivale all'impostazione del primo bit del membro Value a 32 bit (0x00000001).

Discard

Specifica che il driver di visualizzazione in modalità utente può rimuovere il contenuto precedente dell'intera risorsa. Il driver può sfruttare questa funzionalità per ottimizzare le prestazioni e l'utilizzo della memoria.

L'impostazione di questo membro equivale all'impostazione del secondo bit del membro Value a 32 bit (0x00000002).

Reserved1

Questo membro è riservato e deve essere impostato su zero.

L'impostazione di questo membro su zero equivale all'impostazione dei bit da 3 a 24 (0x00FFFFFC) del membro Value a 32 bit su zeri.

BoxValid

Specifica che un'area di destinazione della sottorisorsa in cui eseguire la copia è valida. Se non impostato, è necessario aggiornare l'intera sottorisorsa.

L'impostazione di questo membro equivale all'impostazione del venticinquesimo bit del membro Value a 32 bit (0x01000000).

Reserved2

Questo membro è riservato e deve essere impostato su zero.

L'impostazione di questo membro su zero equivale all'impostazione dei bit da 26 a 32 (0xFE000000) del membro Value a 32 bit su zeri.

Value

Membro nell'unione che D3DDDIARG_COPYFLAGS contiene che può contenere un valore a 32 bit che identifica come gestire il contenuto esistente di una risorsa durante un'operazione di copia o aggiornamento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1
Server minimo supportato	Windows Server 2012 R2
Intestazione	d3dumddi.h (include D3d10umddi.h)

Vedi anche

D3DDDIARG_UPDATESUBRESOURCEUP