estructura D3DDDI_LOCKASYNCFLAGS (d3dumddi.h)

La estructura de D3DDDI_LOCKASYNCFLAGS identifica cómo bloquear un recurso.

Sintaxis

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;

Miembros

NoOverwrite

Valor UINT que especifica si el recurso bloqueado puede tener datos anexados a él, pero no se pueden modificar los datos existentes en el recurso. Este miembro solo se usa con bloqueos de búfer de vértices de Microsoft Direct3D.

Establecer este miembro equivale a establecer el primer bit del miembro Value de 32 bits (0x00000001).

Discard

Valor UINT que especifica si se modifica todo el recurso bloqueado. Si se establece este valor, porque se puede descartar el contenido existente, el contenido no requiere ningún procesamiento preliminar.

Establecer este miembro equivale a establecer el segundo bit del miembro Value de 32 bits (0x00000002).

RangeValid

Valor UINT que especifica si el recurso bloqueado es lineal.

Establecer este miembro equivale a establecer el tercer bit del miembro Value de 32 bits (0x00000004).

AreaValid

Valor UINT que especifica si el recurso bloqueado es una superficie.

Establecer este miembro equivale a establecer el cuarto bit del miembro Value de 32 bits (0x00000008).

BoxValid

Valor UINT que especifica si el recurso bloqueado es un volumen.

Establecer este miembro equivale a establecer el quinto bit del miembro Value de 32 bits (0x00000010).

NoExistingReferences

Valor UINT que especifica si el tiempo de ejecución de Microsoft Direct3D tiene referencias en cola al recurso que se van a bloquear. Si NoExistingReferences está establecido, el controlador determina que no hay referencias en cola internamente al recurso disponibles. A continuación, el controlador puede establecer la marca de campo de bits NoExistingReferences de la estructura de D3DDDICB_LOCK cuando el controlador llama a la función pfnLockCb para realizar una operación de descarte de bloqueo.

Establecer este miembro equivale a establecer el sexto bit del miembro Value de 32 bits (0x00000020).

NotifyOnly

Valor UINT que especifica si la llamada de bloqueo es solo para notificación. El tiempo de ejecución de Direct3D establece NotifyOnly en TRUE cuando bloquea las superficies de memoria del sistema asignadas por el tiempo de ejecución. En esta situación, el runtime omite el puntero que devuelve el controlador en el miembro pSurfData de la estructura D3DDDIARG_LOCKASYNC .

Establecer este miembro equivale a establecer el séptimo bit del miembro Value de 32 bits (0x00000040).

Reserved

Este miembro está reservado y debe establecerse en cero. Establecer este miembro en cero equivale a establecer los 25 bits restantes (0xFFFFFF80) del miembro Value de 32 bits en ceros.

Value

Miembro de la unión contenida en D3DDDI_LOCKASYNCFLAGS que puede contener un valor de 32 bits que identifica cómo bloquear un recurso.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado	d3dumddi.h (incluya D3dumddi.h)

Consulte también

D3DDDIARG_LOCKASYNC