struttura D3DKMT_LOCK (d3dkmthk.h)

Articolo
10/23/2024

La struttura D3DKMT_LOCK descrive i parametri per bloccare un'allocazione.

Sintassi

typedef struct _D3DKMT_LOCK {
  [in]  D3DKMT_HANDLE          hDevice;
  [in]  D3DKMT_HANDLE          hAllocation;
  [in]  UINT                   PrivateDriverData;
  [in]  UINT                   NumPages;
  [in]  const UINT             *pPages;
  [out] VOID                   *pData;
  [in]  D3DDDICB_LOCKFLAGS     Flags;
        D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DKMT_LOCK;

Membri

[in] hDevice

Tipo di dati D3DKMT_HANDLE che rappresenta un handle in modalità kernel per il dispositivo a cui è associata l'allocazione.

[in] hAllocation

Tipo di dati D3DKMT_HANDLE che rappresenta un handle in modalità kernel per l'allocazione da bloccare.

[in] PrivateDriverData

Valore UINT che specifica 32 bit di dati privati (ad esempio, livello MIP) inviato dalla configurazione ICD OpenGL alla funzione dxgkDdiAcquireSwizzlingRange del driver miniport.

[in] NumPages

Numero di pagine nell'elenco di pagine specificato pPages.

[in] pPages

Matrice di pagine da bloccare. Ogni pagina della matrice è descritta da un offset integer. Zero indica la prima pagina della superficie, uno significa il secondo e così via.

[out] pData

Puntatore alla memoria restituita dal driver miniport di visualizzazione e dal gestore della memoria. Quando si blocca un elenco di pagine di memoria, il puntatore restituito è un puntatore alla prima pagina di memoria.

[in] Flags

Struttura D3DDDICB_LOCKFLAGS che identifica, in flag di campo di bit, come bloccare l'allocazione.

Si noti che la specifica di alcuni flag insieme non è valida e che alcuni flag dipendono da altri flag. Per altre informazioni su queste combinazioni, vedere la sezione Osservazioni di D3DDDICB_LOCKFLAGS.

GpuVirtualAddress

Questo membro è riservato e deve essere impostato su zero.

Questo membro è disponibile a partire da Windows 7.