DXGKARG_ACQUIRESWIZZLINGRANGE struttura (d3dkmddi.h)

La struttura DXGKARG_ACQUIRESWIZZLINGRANGE descrive i parametri per rendere accessibile un'allocazione tramite un'apertura della CPU.

Sintassi

typedef struct _DXGKARG_ACQUIRESWIZZLINGRANGE {
  [in]     HANDLE           hAllocation;
  [in]     UINT             PrivateDriverData;
  [in]     UINT             RangeId;
  [in]     UINT             SegmentId;
  [in]     SIZE_T           RangeSize;
  [in/out] PHYSICAL_ADDRESS CPUTranslatedAddress;
} DXGKARG_ACQUIRESWIZZLINGRANGE;

Members

[in] hAllocation

Handle per l'allocazione assegnata dal driver miniport visualizzato e restituito tramite la relativa funzione DxgkDdiCreateAllocation .

[in] PrivateDriverData

Valore UINT dei dati privati inviati dal driver di visualizzazione in modalità utente quando chiama la funzione pfnLockCb del runtime di Microsoft Direct3D. I dati privati devono essere un indice che consente al driver miniport visualizzato di determinare la parte accessibile dell'allocazione, ad esempio il livello MIP. Questo membro non deve contenere un puntatore.

[in] RangeId

Identificatore in base zero dell'intervallo swizzling che i programmi di funzione DxgkDdiAcquireSwizzlingRange .

[in] SegmentId

Identificatore di un segmento in cui l'allocazione è attualmente in pagina.

[in] RangeSize

Dimensioni, in byte, dell'intervallo da acquisire. Questa dimensione dell'intervallo è identica alle dimensioni dell'allocazione per cui DxgkDdiAcquireSwizzlingRange acquisisce un intervallo. Il driver può modificare il valore in RangeSize quando il flag di campo a bit UseAlternateVA viene specificato nel membro Flag della struttura D3DDDICB_LOCKFLAGS in una chiamata alla funzione pfnLockCb . Se il flag UseAlternateVA non è specificato, il driver non può modificare RangeSize.

[in/out] CPUTranslatedAddress

Indirizzo fisico di base in cui la CPU deve eseguire il mapping dell'allocazione. Il driver miniport visualizzato deve impostare queste informazioni quando una chiamata alla relativa funzione DxgkDdiAcquireSwizzlingRange ha esito positivo.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Intestazione d3dkmddi.h (include D3dkmddi.h)

Vedi anche

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

DxgkDdiCreateAllocation

pfnLockCb