D3DDDICB_LOCK struttura (d3dumddi.h)

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

Sintassi

typedef struct _D3DDDICB_LOCK {
  [in/out] D3DKMT_HANDLE          hAllocation;
  [in]     UINT                   PrivateDriverData;
  [in]     UINT                   NumPages;
  [in]     const UINT             *pPages;
  [out]    VOID                   *pData;
  [in]     D3DDDICB_LOCKFLAGS     Flags;
           D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDICB_LOCK;

Members

[in/out] hAllocation

Tipo di dati D3DKMT_HANDLE che rappresenta un handle in modalità kernel per l'allocazione. La funzione pfnAllocateCb del runtime di Microsoft Direct3D restituisce questo handle. Pertanto, il driver di visualizzazione in modalità utente deve usare questo handle per bloccare l'allocazione.

Se il flag Dissegna il campo bit viene impostato nel membro Flags , gestione memoria video crea una nuova istanza dell'allocazione e restituisce un nuovo handle che rappresenta la nuova istanza.

[in] PrivateDriverData

Dati privati (ad esempio, livello MIP) inviati dal driver di visualizzazione in modalità utente alla funzione DxgkDdiAcquireSwizzlingRange del driver di visualizzazione.

[in] NumPages

Numero di pagine nell'elenco di pagine a cui fa riferimento pPages.

[in] pPages

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

[out] pData

Puntatore alla memoria restituita dal driver miniport visualizzato e dal gestore 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 a 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 sulla specifica di questi flag, 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.

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

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

pfnLockCb