Compartilhar via

estrutura D3DDDIARG_LOCKASYNC (d3dumddi.h)

  • Artigo

A estrutura D3DDDIARG_LOCKASYNC descreve um recurso ou uma superfície dentro do recurso a ser bloqueado.

Sintaxe

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;

Membros

[in] hResource

Um identificador para o recurso a ser bloqueado.

[in] SubResourceIndex

O índice baseado em zero no recurso que hResource especifica. Esse índice indica o sub-recurso ou a superfície a ser bloqueada.

[in] Flags

Uma estrutura D3DDDI_LOCKASYNCFLAGS que indica, em sinalizadores de campo de bit, como bloquear o recurso.

Nota Alguns sinalizadores são mutuamente exclusivos com outros sinalizadores. Para obter mais informações, consulte a seção Comentários a seguir.
 

[in] Range

Uma estrutura D3DDDIRANGE que descreve o subintervalo do recurso linear a ser bloqueado, se o sinalizador de campo de bits RangeValid estiver definido na estrutura D3DDDI_LOCKASYNCFLAGS especificada por Flags .

[in] Area

Uma estrutura RECT que descreve o subrectângulo da superfície a ser bloqueada, se o sinalizador de campo de bits AreaValid estiver definido na estrutura D3DDDI_LOCKASYNCFLAGS especificada por Flags .

[in] Box

Uma estrutura D3DDDIBOX que descreve o subvolume do volume a ser bloqueado, se o sinalizador de campo de bits BoxValid estiver definido na estrutura D3DDDI_LOCKASYNCFLAGS especificada por Flags .

[out] hCookie

Um identificador que representa o recurso renomeado. Esse identificador só será válido se o sinalizador Descartar campo de bits estiver definido na estrutura D3DDDI_LOCKASYNCFLAGS especificada por Flags .

[out] pSurfData

Um ponteiro para a região de memória do recurso que foi bloqueado. A função LockAsync do driver de exibição no modo de usuário retorna esse ponteiro para o runtime do Microsoft Direct3D.

[out] Pitch

O tom, em bytes, da superfície que estava bloqueada. A função LockAsync do driver de exibição no modo de usuário retorna esse valor de pitch para o runtime do Direct3D.

[out] SlicePitch

O tom de fatia, em bytes, da superfície que estava bloqueada. A função LockAsync do driver de exibição no modo de usuário retorna esse valor de inclinação de fatia para o runtime do Direct3D.

GpuVirtualAddress

Esse membro é reservado e deve ser definido como zero.

Este membro está disponível a partir do Windows 7.

Comentários

Os membros da estrutura D3DDDI_LOCKASYNCFLAGS especificada pelo membro Flags devem seguir as seguintes regras:

  • O sinalizador de campo de bits NoOverwrite não deve ser definido simultaneamente com o sinalizador Descartar campo de bits.
  • Somente um dos sinalizadores de campo de bit RangeValid, AreaValid e BoxValid deve ser definido a qualquer momento.

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

D3DDDI_LOCKASYNCFLAGS

LockAsync

RECT