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

  • Artículo

DXGKCB_GETHANDLEPARENT recupera el recurso primario de la asignación especificada.

Sintaxis

DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;

D3DKMT_HANDLE DxgkcbGethandleparent(
  [in] IN_D3DKMT_HANDLE hAllocation
)
{...}

Parámetros

[in] hAllocation

Identificador de una asignación. Este identificador debe ser el identificador de modo kernel que el subsistema del kernel de gráficos directX (Dxgkrnl.sys) asignado para la asignación.

Valor devuelto

DXGKCB_GETHANDLEPARENT devuelve un identificador específico del subsistema de gráficos al recurso primario para la asignación asociada al identificador que especifica el parámetro hAllocation .

Si DXGKCB_GETHANDLEPARENT devuelve un identificador NULL, Dxgkrnl.sys no pudo resolver el identificador en el recurso primario por un motivo como las siguientes posibilidades:

  • Se recibió un identificador no válido del controlador de pantalla en modo de usuario debido a un ataque malintencionado o a algún otro error.
  • Las asignaciones tenían problemas de duración.

Si se devuelve un identificador NULL, el controlador de minipuerto de pantalla debe producir un error en su función DDI que se está ejecutando actualmente con STATUS_INVALID_HANDLE.

Comentarios

Para DXGKCB_GETHANDLEPARENT devolver un identificador de recursos, el identificador de hAllocation debe ser un identificador de asignación asociado a un recurso; de lo contrario, DXGKCB_GETHANDLEPARENT devuelve NULL.

DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, llame a DxgkCbGetHandleParent a través del DXGKRNL_INTERFACE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista (WDDM 1.0)
Plataforma de destino Escritorio
Encabezado d3dkmddi.h (incluya D3dkmddi.h)
IRQL < DISPATCH_LEVEL

Consulte también

DXGKRNL_INTERFACE