Compartilhar via


estrutura D3DDDICB_LOCK (d3dumddi.h)

A estrutura D3DDDICB_LOCK descreve parâmetros para bloquear uma alocação.

Sintaxe

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;

Membros

[in/out] hAllocation

Um tipo de dados D3DKMT_HANDLE que representa um identificador de modo kernel para a alocação. A função pfnAllocateCb do runtime do Microsoft Direct3D retorna esse identificador. Portanto, o driver de exibição do modo de usuário deve usar esse identificador para bloquear a alocação.

Se o sinalizador Descartar campo de bits estiver definido no membro Flags , o gerenciador de memória de vídeo criará uma nova instância da alocação e retornará um novo identificador que representa a nova instância.

[in] PrivateDriverData

Dados privados (por exemplo, nível MIP) que são enviados do driver de exibição do modo de usuário para a função DxgkDdiAcquireSwizzlingRange do driver de miniporta de exibição.

[in] NumPages

O número de páginas na lista de páginas apontadas por pPages.

[in] pPages

Uma matriz de páginas a serem bloqueadas. Cada página na matriz é descrita por um deslocamento inteiro. Zero significa a primeira página na superfície, uma significa a segunda e assim por diante.

[out] pData

Um ponteiro para a memória retornada do driver de miniporta de exibição e do gerenciador de memória. Ao bloquear uma lista de páginas de memória, o ponteiro retornado é um ponteiro para a primeira página de memória.

[in] Flags

Uma estrutura D3DDDICB_LOCKFLAGS que identifica, em sinalizadores de campo de bit, como bloquear a alocação.

Observe que especificar alguns sinalizadores juntos é inválido e que alguns sinalizadores dependem de outros sinalizadores. Para obter mais informações sobre como especificar esses sinalizadores, consulte a seção Comentários do D3DDDICB_LOCKFLAGS.

GpuVirtualAddress

Esse membro é reservado e deve ser definido como zero.

Este membro está disponível a partir do Windows 7.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho d3dumddi.h (inclua D3dumddi.h)

Confira também

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

pfnLockCb