DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA función de devolución de llamada (d3dkmddi.h)

Artículo
05/26/2023

La función DxgkDdiGetStandardAllocationDriverData devuelve una descripción de un tipo de asignación estándar.

Sintaxis

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

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

Parámetros

[in] hAdapter

Identificador de un bloque de contexto asociado a un adaptador de pantalla. El controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de Microsoft DirectX en el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .

[in/out] pGetStandardAllocationDriverData

Puntero a una estructura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA que describe una asignación estándar.

Valor devuelto

DxgkDdiGetStandardAllocationDriverData devuelve uno de los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	DxgkDdiGetStandardAllocationDriverData devolvió correctamente una descripción del tipo de asignación estándar.
STATUS_NO_MEMORY	DxgkDdiGetStandardAllocationDriverData no pudo asignar memoria necesaria para que se completara.

Comentarios

Los tipos de asignación estándar son asignaciones que se deben crear en modo kernel sin comunicación desde el controlador de visualización en modo de usuario. El subsistema del kernel de gráficos de DirectX llama a la función DxgkDdiGetStandardAllocationDriverData para generar una descripción del tipo de asignación estándar que especifica el parámetro pGetStandardAllocationDriverData . El controlador de minipuerto para mostrar devuelve la descripción del tipo de asignación en los miembros pAllocationPrivateDriverData y pResourcePrivateDriverData de la estructura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA a la que apunta el parámetro pGetStandardAllocationDriverData . Posteriormente, el subsistema del kernel de gráficos directX pasa la descripción a la función DxgkDdiCreateAllocation para crear realmente la asignación.

A partir de Windows 7, si un controlador de minipuerto de pantalla procesa una llamada a la función DxgkDdiGetStandardAllocationDriverData para crear asignaciones para la aceleración de hardware GDI, el controlador debe establecer el tono de asignación de las asignaciones visibles de cpu, pGetStandardAllocationDriverData-pCreateGdiSurfaceData-Pitch>>.

DxgkDdiGetStandardAllocationDriverData debe ser paginable.