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

Artículo
05/26/2023

La función DxgkDdiDescribeAllocation recupera información sobre una asignación existente que de lo contrario no está disponible 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 miniporte de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de DirectX en el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .

[in/out] pDescribeAllocation

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

Valor devuelto

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

Comentarios

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

Asignaciones que también son principales (es decir, asignaciones que el controlador de visualización en modo de usuario creado estableciendo la marca de campo de bits principal en el miembro Flags 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 miembro hSource de la estructura de DXGKARG_PRESENT en una llamada a la función DxgkDdiPresent del controlador de miniporte para mostrar).

DxgkDdiDescribeAllocation debe ser paginable.