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

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 KMD (driver de exibição do modo kernel) forneceu anteriormente esse identificador para Dxgkrnl em sua função DxgkDdiAddDevice .

[in/out] pGetStandardAllocationDriverData

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

Valor de retorno

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 puderam alocar memória necessária para que ela fosse concluída.

Observações

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 no modo de usuário.

Dxgkrnl chama a função DxgkDdiGetStandardAllocationDriverData do driver do modo kernel para gerar uma descrição do tipo de alocação padrão que o parâmetro pGetStandardAllocationDriverData especifica. KMD retorna a descrição do tipo de alocação no pAllocationPrivateDriverData e pResourcePrivateDriverData membros da estrutura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA para os quais o parâmetro pGetStandardAllocationDriverData aponta. Dxgkrnl posteriormente passa a descrição para a função DxgkDdiCreateAllocation para realmente criar a alocação.

Começando com o Windows 7, se o KMD processar uma chamada para a função DxgkDdiGetStandardAllocationDriverDa ta para criar alocações para aceleração de hardware GDI, o driver deverá definir o tom da alocação para alocações visíveis da CPU, **pGetStandardAllocationDriverData->pCreateGdiSurfaceData->**Pitch.

DxgkDdiGetStandardAllocationDriverData deve ficar paginável.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Consulte também

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA

DxgkDdiAddDevice

DxgkDdiCreateAllocation