estructura de D3DDDIARG_LOCKASYNC (d3dumddi.h)

  • Artículo

La estructura D3DDDIARG_LOCKASYNC describe un recurso o una superficie dentro del recurso que se va a bloquear.

Sintaxis

typedef struct _D3DDDIARG_LOCKASYNC {
  [in]  HANDLE                 hResource;
  [in]  UINT                   SubResourceIndex;
  [in]  D3DDDI_LOCKASYNCFLAGS  Flags;
  union {
    [in]  D3DDDIRANGE Range;
    [in]  RECT        Area;
    [in]  D3DDDIBOX   Box;
  };
  [out] HANDLE                 hCookie;
  [out] VOID                   *pSurfData;
  [out] UINT                   Pitch;
  [out] UINT                   SlicePitch;
        D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDIARG_LOCKASYNC;

Miembros

[in] hResource

Identificador del recurso que se va a bloquear.

[in] SubResourceIndex

Índice de base cero en el recurso que hResource especifica. Este índice indica el subrecurso o la superficie que se va a bloquear.

[in] Flags

Estructura D3DDDI_LOCKASYNCFLAGS que indica, en marcas de campo de bits, cómo bloquear el recurso.

Nota Algunas marcas son mutuamente excluyentes con otras marcas. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
 

[in] Range

Estructura D3DDDIRANGE que describe el subrango del recurso lineal que se va a bloquear, si la marca de campo de bits RangeValid está establecida en la estructura D3DDDI_LOCKASYNCFLAGS que especifica Flags .

[in] Area

Estructura RECT que describe el subrectangle de la superficie que se va a bloquear, si la marca de campo de bits AreaValid está establecida en la estructura D3DDDI_LOCKASYNCFLAGS que Flags especifica.

[in] Box

Estructura de D3DDDIBOX que describe el subvolumen del volumen que se va a bloquear, si la marca de campo de bits BoxValid está establecida en la estructura de D3DDDI_LOCKASYNCFLAGS que especifica Flags .

[out] hCookie

Identificador que representa el recurso cuyo nombre ha cambiado. Este identificador solo es válido si la marca Descartar campo de bits está establecida en la estructura de D3DDDI_LOCKASYNCFLAGS que especifica Flags .

[out] pSurfData

Puntero a la región de memoria del recurso bloqueado. La función LockAsync del controlador de pantalla en modo de usuario devuelve este puntero al entorno de ejecución de Microsoft Direct3D.

[out] Pitch

Tono, en bytes, de la superficie bloqueada. La función LockAsync del controlador de pantalla en modo de usuario devuelve este valor de tono al tiempo de ejecución de Direct3D.

[out] SlicePitch

Tono de segmento, en bytes, de la superficie bloqueada. La función LockAsync del controlador de pantalla en modo de usuario devuelve este valor de tono de segmento al tiempo de ejecución de Direct3D.

GpuVirtualAddress

Este miembro está reservado y debe establecerse en cero.

Este miembro está disponible a partir de Windows 7.

Comentarios

Los miembros de la estructura D3DDDI_LOCKASYNCFLAGS que especifica el miembro Flags deben cumplir las reglas siguientes:

  • La marca de campo de bits NoOverwrite no debe establecerse simultáneamente con la marca Descartar campo de bits.
  • Solo se debe establecer una de las marcas rangeValid, AreaValid y BoxValid de campo de bits en cualquier momento.

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

D3DDDI_LOCKASYNCFLAGS

LockAsync

RECT