estrutura DXGKARGCB_PINFRAMEBUFFERFORSAVE2 (d3dkmddi.h)

Artigo
08/07/2023

A estrutura DXGKARGCB_PINFRAMEBUFFERFORSAVE2 contém as informações usadas pela função de retorno de chamada DXGKCB_PINFRAMEBUFFERFORSAVE2 para fixar um buffer de quadro inteiro ao mesmo tempo.

Sintaxe

typedef struct _DXGKARGCB_PINFRAMEBUFFERFORSAVE2 {
  [in]  UINT     PhysicalAdapterIndex;
  [in]  SIZE_T   CommitSize;
  union {
    struct {
      UINT PreferContiguous : 1;
      UINT Reserved : 31;
    };
          UINT Value;
  } Flags;
  [out] DXGK_ADL *pAdl;
} DXGKARGCB_PINFRAMEBUFFERFORSAVE2;

Membros

[in] PhysicalAdapterIndex

O índice do adaptador físico.

[in] CommitSize

O tamanho, em bytes, que o driver requer para fixar. Esse tamanho deve ser um múltiplo de PAGE_SIZE e deve ser menor ou igual ao tamanho máximo especificado pelo driver na estrutura DXGK_FRAMEBUFFERSAVEAREA quando o retorno de chamada DxgkDdiQueryAdapterInfo do driver é chamado com DXGKQAITYPE_FRAMEBUFFERSAVESIZE durante a inicialização do driver.

Flags

Flags.PreferContiguous

Indica que o driver pode usar uma ADL (lista de descritores de endereço contíguo) nesse caminho e é preferível a uma matriz de páginas. Quando o remapeamento lógico está habilitado, isso pode economizar uma grande quantidade de memória ao alocar o ADL com base em CommitSize. Esse sinalizador se comporta de forma idêntica ao sinalizador de mesmo nome em DXGKARGCB_ALLOCATE_ADL ao alocar um ADL.

Flags.Reserved

Reservados; deve ser definido como zero.

Flags.Value

Uma maneira alternativa de acessar os bits sinalizadores .

[out] pAdl

Em uma chamada bem-sucedida para DXGKCB_PINFRAMEBUFFERFORSAVE2, aponta para a estrutura DXGK_ADL com uma lista de páginas da área de salvamento do buffer de quadros. Essas páginas têm a garantia de serem mapeadas para o IoMmu.