DXGKDDI_DESCRIBEALLOCATION função de retorno de chamada (d3dkmddi.h)

Artigo
02/23/2024

A função DxgkDdiDescribeAllocation recupera informações sobre uma alocação existente que, de outra forma, não está disponível para o subsistema de kernel de elementos gráficos do Microsoft DirectX.

Sintaxe

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

NTSTATUS DxgkddiDescribeallocation(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}

Parâmetros

[in] hAdapter

Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporta de exibição forneceu anteriormente esse identificador para o subsistema kernel de elementos gráficos DirectX no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .

[in/out] pDescribeAllocation

Um ponteiro para uma estrutura DXGKARG_DESCRIBEALLOCATION que descreve uma alocação existente.

Retornar valor

DxgkDdiDescribeAllocation retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

Como o subsistema de kernel de elementos gráficos DirectX não mantém necessariamente registros de alocações, o subsistema de kernel gráfico chama DxgkDdiDescribeAllocation para solicitar que o driver de miniporto de exibição retorne informações sobre alocações existentes. Atualmente, o driver de miniporta de exibição deve ser capaz de retornar essas informações para as seguintes alocações:

Alocações que também são primárias (ou seja, alocações que o driver de exibição do modo de usuário criou definindo o sinalizador de campo de bit primário no membro Flags da estrutura D3DDDI_ALLOCATIONINFO em uma chamada para a função pfnAllocateCb ).
Alocações que podem ser a origem de uma apresentação (ou seja, alocações representadas pelo membro hSource da estrutura DXGKARG_PRESENT em uma chamada para a função DxgkDdiPresent do driver de miniporto de exibição).

DxgkDdiDescribeAllocation deve ser tornado paginável.