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

Artículo
02/06/2025

La función DxgkDdiDescribeAllocation recupera información sobre una asignación existente que no está disponible de otro modo para el subsistema del kernel de gráficos de Microsoft DirectX.

Sintaxis

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

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

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 gráfico de DirectX en la función MiniportDeviceContext parámetro de salida del DxgkDdiAddDevice función.

[in/out] pDescribeAllocation

Puntero a una estructura DXGKARG_DESCRIBEALLOCATION que describe una asignación existente.

Valor devuelto

DxgkDdiDescribeAllocation devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.

Observaciones

Dado que el subsistema del kernel de gráficos directX no mantiene necesariamente registros de asignaciones, el subsistema del kernel gráfico llama a DxgkDdiDescribeAllocation para solicitar que el controlador de miniporte para mostrar devuelva información sobre las asignaciones existentes. Actualmente, el controlador de miniporte de pantalla debe poder devolver esta información para las siguientes asignaciones:

Asignaciones que también son principales (es decir, las asignaciones que creó el controlador de visualización en modo de usuario estableciendo el marca de campo de bits principal en el Flags miembro de la estructura D3DDDI_ALLOCATIONINFO en una llamada a la función pfnAllocateCb).
Asignaciones que podrían ser el origen de una presentación (es decir, asignaciones representadas por el hSource miembro de la estructura DXGKARG_PRESENT en una llamada al controlador de miniporte para mostrar función DxgkDdiPresent).

dxgkDdiDescribeAllocation debe ser paginable.