D3DDDIARG_LOCKASYNC struttura (d3dumddi.h)

Articolo
08/07/2023

La struttura D3DDDIARG_LOCKASYNC descrive una risorsa o una superficie all'interno della risorsa da bloccare.

Sintassi

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;

Members

[in] hResource

Handle per la risorsa da bloccare.

[in] SubResourceIndex

Indice in base zero nella risorsa specificata da hResource . Questo indice indica la sottoresource o la superficie da bloccare.

[in] Flags

Struttura D3DDDI_LOCKASYNCFLAGS che indica, in flag di campo a bit, come bloccare la risorsa.

Nota Alcuni flag si escludono reciprocamente con altri flag. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[in] Range

Struttura D3DDDIRANGE che descrive la sottorange della risorsa lineare da bloccare, se il flag di campo a bit RangeValid è impostato nella struttura D3DDDI_LOCKASYNCFLAGS specificata da Flags .

[in] Area

Struttura RECT che descrive il subrectangle della superficie da bloccare, se il flag di campo a bit AreaValid è impostato nella struttura D3DDDI_LOCKASYNCFLAGS specificata da Flags .

[in] Box

Struttura D3DDDIBOX che descrive la sottovolume del volume da bloccare, se il flag di campo a bit BoxValid è impostato nella struttura D3DDDI_LOCKASYNCFLAGS specificata da Flag .

[out] hCookie

Handle che rappresenta la risorsa rinominata. Questo handle è valido solo se il flag di campo a bit di eliminazione è impostato nella struttura D3DDDI_LOCKASYNCFLAGS specificata da Flag .

[out] pSurfData

Puntatore all'area di memoria per la risorsa bloccata. La funzione LockAsync del driver in modalità utente restituisce questo puntatore al runtime di Microsoft Direct3D.

[out] Pitch

Il passo, in byte, della superficie bloccata. La funzione LockAsync del driver in modalità utente restituisce questo valore di passo al runtime Direct3D.

[out] SlicePitch

Il passo della sezione, in byte, della superficie bloccata. La funzione LockAsync del driver di visualizzazione in modalità utente restituisce questo valore di passo della sezione al runtime Direct3D.

GpuVirtualAddress

Questo membro è riservato e deve essere impostato su zero.

Questo membro è disponibile a partire da Windows 7.

Commenti

I membri della struttura D3DDDI_LOCKASYNCFLAGS specificati dal membro Flags devono rispettare le regole seguenti:

Il flag di campo di bit NoOverwrite non deve essere impostato contemporaneamente con il flag Disascrittura bit.
Solo uno dei flag RangeValid, AreaValid e BoxValid deve essere impostato in qualsiasi momento.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	d3dumddi.h (include D3dumddi.h)

Vedi anche

D3DDDI_LOCKASYNCFLAGS

LockAsync

RECT

Share via