estrutura D3DDDIARG_LOCKASYNC (d3dumddi.h)

Artigo
02/06/2025

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 a sub-fonte 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.

Observação 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 subconjunto do recurso linear a ser bloqueado, se o RangeValid sinalizador de campo de bits for definido na estrutura de D3DDDI_LOCKASYNCFLAGS que Sinalizadores especificar.

[in] Area

Uma estrutura RECT que descreve o subrectangle da superfície a ser bloqueada, se o sinalizador AreaValid campo de bits estiver definido na estrutura D3DDDI_LOCKASYNCFLAGS que Sinalizadores especificar.

[in] Box

Uma estrutura D3DDDIBOX que descreve o subvolume do volume a ser bloqueado, se o sinalizador BoxValid campo de bits for definido na estrutura D3DDDI_LOCKASYNCFLAGS que Sinalizadores especificar.

[out] hCookie

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

[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 do 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 do 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 do modo de usuário retorna esse valor de pitch 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.

Observações

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

O sinalizador noOverwrite campo de bits não deve ser definido simultaneamente com o sinalizador Descartar campo de bits.
Apenas um dos RangeValid, AreaValid e sinalizadores de campo de bits do BoxValid devem ser definidos a qualquer momento.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
cabeçalho	d3dumddi.h (inclua D3dumddi.h)

Consulte também

D3DDDI_LOCKASYNCFLAGS

LockAsync

RECT

Partilhar via