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

Artículo
11/11/2024

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. Anteriormente, el controlador de pantalla en modo kernel (KMD) proporcionó este identificador para Dxgkrnl en su función DxgkDdiAddDevice.

[in/out] pGetStandardAllocationDriverData

Puntero a una estructuraDXGKARG_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 se pudo asignar memoria necesaria para que se complete.

Observaciones

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.

dxgkrnl llama a la función dxgkDdiGetStandardAllocationDriverData para generar una descripción del tipo de asignación estándar que especifica el parámetro pGetStandardAllocationDriverData . KMD devuelve la descripción del tipo de asignación del pAllocationPrivateDriverData y pResourcePrivateDriverData miembros de la estructura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA a los que apunta el parámetro pGetStandardAllocationDriverData. dxgkrnl pasa posteriormente la descripción a la función dxgkDdiCreateAllocation para crear realmente la asignación.

A partir de Windows 7, si KMD procesa una llamada a la DxgkDdiGetStandardAllocationDriverData función 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.