estrutura DXGKARG_ACQUIRESWIZZLINGRANGE (d3dkmddi.h)

A estrutura DXGKARG_ACQUIRESWIZZLINGRANGE descreve parâmetros para tornar uma alocação acessível por meio de uma abertura de CPU.

Sintaxe

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;

Membros

[in] hAllocation

Um identificador para a alocação atribuída pelo driver de miniporto de exibição e que é retornado por meio de sua função DxgkDdiCreateAllocation .

[in] PrivateDriverData

Um valor UINT de dados privados que o driver de exibição do modo de usuário envia quando chama a função pfnLockCb do runtime do Microsoft Direct3D. Os dados privados devem ser um índice que permite que o driver de miniporta de exibição determine a parte acessível da alocação (por exemplo, o nível da MIP). Esse membro não deve conter um ponteiro.

[in] RangeId

O identificador baseado em zero do intervalo de giros que a função DxgkDdiAcquireSwizzlingRange programa.

[in] SegmentId

O identificador de um segmento no qual a alocação está paginada no momento.

[in] RangeSize

O tamanho, em bytes, do intervalo a ser adquirido. Esse tamanho de intervalo é idêntico ao tamanho da alocação para a qual DxgkDdiAcquireSwizzlingRange adquire um intervalo. O driver pode modificar o valor em RangeSize quando o sinalizador de campo de bits UseAlternateVA é especificado no membro Flags da estrutura D3DDDICB_LOCKFLAGS em uma chamada para a função pfnLockCb . Se o sinalizador UseAlternateVA não for especificado, o driver não poderá alterar RangeSize.

[in/out] CPUTranslatedAddress

O endereço físico base em que a CPU deve mapear a alocação. O driver de miniporto de exibição deve definir essas informações quando uma chamada para sua função DxgkDdiAcquireSwizzlingRange for bem-sucedida.

Requisitos

Confira também

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

DxgkDdiCreateAllocation

pfnLockCb