struttura D3DDDIARG_LOCK (d3dumddi.h)

Articolo
03/08/2023

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

Sintassi

typedef struct _D3DDDIARG_LOCK {
  [in]  HANDLE           hResource;
  [in]  UINT             SubResourceIndex;
  union {
    [in]  D3DDDIRANGE Range;
    [in]  RECT        Area;
    [in]  D3DDDIBOX   Box;
  };
  [out] VOID             *pSurfData;
  [out] UINT             Pitch;
  [out] UINT             SlicePitch;
  [in]  D3DDDI_LOCKFLAGS Flags;
} D3DDDIARG_LOCK;

Members

[in] hResource

Handle per la risorsa da bloccare.

[in] SubResourceIndex

Indice in base zero nella risorsa, specificato dall'handle specificato da hResource. Questo indice indica la sottorisorsa o la superficie da bloccare.

[in] Range

Struttura D3DDDIRANGE che descrive l'intervallo secondario della risorsa lineare da bloccare.

[in] Area

Struttura RECT che descrive il subrectangle della superficie da bloccare.

[in] Box

Struttura D3DDDIBOX che descrive la sottovolume del volume da bloccare.

[out] pSurfData

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

[out] Pitch

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

[out] SlicePitch

Inclinazione della sezione, in byte, della superficie bloccata. La funzione Lock del driver di visualizzazione in modalità utente restituisce questo valore di inclinazione della sezione al runtime Direct3D.

[in] Flags

Struttura D3DDDI_LOCKFLAGS che indica, in flag di campo di bit, come bloccare la risorsa. Si noti che alcuni flag si escludono a vicenda con altri flag. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Commenti

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

I flag di campo di bit ReadOnly e WriteOnly non devono essere impostati contemporaneamente.
Il flag di campo di bit NoOverwrite non deve essere impostato contemporaneamente con il flag di campo di bit Discard .
È necessario impostare in qualsiasi momento solo i flag di campo di bit RangeValid, AreaValid e BoxValid .
Il flag di campo di bit ReadOnly non deve essere impostato contemporaneamente con il flag di campo di bit Discard.TheReadOnly bit-field flag must not be setly with the Discard bit-field flag.

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_LOCKFLAGS

Lock

Share via