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

Artigo
02/23/2024

A função DxgkDdiGetStandardAllocationDriverData retorna uma descrição de um tipo de alocação padrão.

Sintaxe

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

NTSTATUS DxgkddiGetstandardallocationdriverdata(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}

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 anteriormente forneceu esse identificador para o subsistema kernel de elementos gráficos do Microsoft DirectX no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .

[in/out] pGetStandardAllocationDriverData

Um ponteiro para uma estrutura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA que descreve uma alocação padrão.

Retornar valor

DxgkDdiGetStandardAllocationDriverData retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	DxgkDdiGetStandardAllocationDriverData retornou com êxito uma descrição do tipo de alocação padrão.
STATUS_NO_MEMORY	DxgkDdiGetStandardAllocationDriverData não pôde alocar memória necessária para que ela fosse concluída.

Comentários

Os tipos de alocação padrão são alocações que devem ser criadas no modo kernel sem comunicação do driver de exibição do modo de usuário. O subsistema de kernel de elementos gráficos DirectX chama a função DxgkDdiGetStandardAllocationDriverData para gerar uma descrição do tipo de alocação padrão especificado pelo parâmetro pGetStandardAllocationDriverData . O driver de miniporto de exibição retorna a descrição do tipo de alocação nos membros pAllocationPrivateDriverData e pResourcePrivateDriverData da estrutura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA para a qual o parâmetro pGetStandardAllocationDriverData aponta. O subsistema de kernel de elementos gráficos DirectX passa posteriormente a descrição para a função DxgkDdiCreateAllocation para realmente criar a alocação.

A partir do Windows 7, se um driver de miniporto de exibição processar uma chamada para a função DxgkDdiGetStandardAllocationDriverData para criar alocações para aceleração de hardware GDI, o driver deverá definir a inclinação da alocação para alocações visíveis da CPU, pGetStandardAllocationDriverData-pCreateGdiSurfaceData-Pitch>>.

DxgkDdiGetStandardAllocationDriverData deve ser tornado paginável.