estrutura DXGKARGCB_CREATECONTEXTALLOCATION (d3dkmddi.h)

Artigo
08/07/2023

A estrutura DXGKARGCB_CREATECONTEXTALLOCATION contém os atributos de alocação de um contexto de GPU ou contexto específico do dispositivo usado na função de retorno de chamada DXGKCB_CREATECONTEXTALLOCATION .

Sintaxe

typedef struct _DXGKARGCB_CREATECONTEXTALLOCATION {
  [in]  DXGK_CREATECONTEXTALLOCATIONFLAGS ContextAllocationFlags;
  [in]  HANDLE                            hAdapter;
  [in]  HANDLE                            hDevice;
  [in]  HANDLE                            hContext;
  [in]  HANDLE                            hDriverAllocation;
  [in]  SIZE_T                            Size;
  [in]  UINT                              Alignment;
  [in]  UINT                              SupportedSegmentSet;
  [in]  UINT                              EvictionSegmentSet;
  [in]  DXGK_SEGMENTPREFERENCE            PreferredSegment;
  [in]  DXGK_SEGMENTBANKPREFERENCE        HintedBank;
  [in]  DXGK_ALLOCATIONINFOFLAGS          Flags;
  [out] HANDLE                            hAllocation;
  [in]  UINT                              PhysicalAdapterIndex;
} DXGKARGCB_CREATECONTEXTALLOCATION;

Membros

[in] ContextAllocationFlags

Uma estrutura DXGK_CREATECONTEXTALLOCATIONFLAGS que especifica as propriedades da alocação.

[in] hAdapter

Um identificador para o adaptador gráfico para o qual a alocação de contexto é criada.

[in] hDevice

Um identificador para o dispositivo de exibição que foi originalmente passado pelo subsistema de elementos gráficos DirectX para a função DxgkDdiCreateDevice do driver de miniporto de exibição.

Observação

Esse membro é definido como NULL para um dispositivo do sistema.

[in] hContext

Se ContextAllocationFlags.SharedAcrossContexts for definido como um valor de 0, esse membro conterá o valor atribuído pelo subsistema de elementos gráficos DirectX para o contexto que foi passado para a função DXGKCB_CREATECONTEXTALLOCATION .

Se ContextAllocationFlags.SharedAcrossContexts for definido como um valor de 1, esse membro deverá ser definido como NULL.

Observação

Esse membro também é definido como NULL para um contexto do sistema.

[in] hDriverAllocation

Um identificador criado pelo driver de miniporto de exibição que identifica a alocação criada. O valor desse membro é posteriormente passado como o membro Transfer.hAllocation da estrutura DXGKARG_BUILDPAGINGBUFFER que é apontado pelo parâmetro pBuildPagingBuffer da função DxgkDdiBuildPagingBuffer .

[in] Size

O tamanho, em bytes, necessário para a alocação.

[in] Alignment

O alinhamento necessário, em bytes, para a alocação.

[in] SupportedSegmentSet

Identificadores de segmento que o driver de miniporto de exibição pode definir no membro PreferredSegment para operações de leitura ou gravação.

[in] EvictionSegmentSet

Identificadores de segmentos que podem ser usados para remoção.

[in] PreferredSegment

Uma estrutura DXGK_SEGMENTPREFERENCE que indica os identificadores de segmento preferenciais que o driver de miniporto de exibição solicita que o gerenciador de memória de vídeo use para colocar a página na alocação.

[in] HintedBank

Uma estrutura DXGK_SEGMENTBANKPREFERENCE que indica as preferências de ordenação bancária que o driver de miniporto de exibição solicita que o gerenciador de memória de vídeo use para colocar a página na alocação.

[in] Flags

Uma estrutura DXGK_ALLOCATIONINFOFLAGS que identifica propriedades para uma alocação em sinalizadores de campo de bit. Essas propriedades indicam o tipo de alocação a ser criada. O driver de miniporto de exibição especifica esses sinalizadores para o gerenciador de memória de vídeo. Consulte Comentários para obter restrições sobre valores de sinalizador.

[out] hAllocation

Um identificador que foi atribuído pelo subsistema de elementos gráficos DirectX à alocação. Esse valor é posteriormente passado como o parâmetro hAllocation da função DXGKCB_DESTROYCONTEXTALLOCATION .

[in] PhysicalAdapterIndex

O índice do adaptador físico. Esse campo está disponível a partir do WDDM 2.0.

Comentários

O driver de miniporto de exibição chama DXGKCB_CREATECONTEXTALLOCATION para alocar um contexto de GPU ou contexto específico do dispositivo. Quando o driver chama essa função, ele passa um ponteiro para uma estrutura DXGKARGCB_CREATECONTEXTALLOCATION por meio do parâmetro ContextAllocation .