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

Artículo
05/26/2023

La función DxgkDdiSetPointerShape establece la apariencia y la ubicación del puntero del mouse.

Sintaxis

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

NTSTATUS DxgkddiSetpointershape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERSHAPE pSetPointerShape
)
{...}

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] pSetPointerShape

Puntero a una estructura DXGKARG_SETPOINTERSHAPE que describe la apariencia y la ubicación del puntero del mouse.

Valor devuelto

DxgkDdiSetPointerShape devuelve uno de los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	El puntero del mouse se dibuja correctamente.
STATUS_NO_MEMORY	DxgkDdiSetPointerShape no pudo asignar memoria necesaria para que se complete.

Comentarios

El subsistema del kernel de gráficos de DirectX llama a la función DxgkDdiSetPointerShape del controlador de miniporte de pantalla para establecer información sobre el puntero del mouse. La función DxgkDdiSetPointerShape se llama independientemente de todas las demás funciones del controlador de miniporte de pantalla. Por lo tanto, un subproceso DxgkDdiSetPointerShape se puede ejecutar simultáneamente con otro subproceso de controlador de minipuerto de pantalla. Sin embargo, el sistema garantiza que los subprocesos DxgkDdiSetPointerShape y DxgkDdiSetPointerPosition no se puedan ejecutar simultáneamente.

Si ejecuta un subproceso DxgkDdiSetPointerShape simultáneamente con otro subproceso de controlador de miniporte de pantalla, el controlador de minipuerto de pantalla debe poder programar el hardware del puntero del mouse independientemente de otras actividades, como las operaciones que envían un búfer de comandos a través del acceso directo a la memoria (DMA) al hardware gráfico, las operaciones que programan el hardware gráfico mediante E/S asignadas por memoria (MMIO), y así sucesivamente.

No se llama a DxgkDdiSetPointerShape si la topología de red presente en vídeo (VidPN) asociada al miembro VidPnSourceId de la estructura DXGKARG_SETPOINTERSHAPE a la que apunta el parámetro pSetPointerShape está deshabilitado.

DxgkDdiSetPointerShape debe ser paginable.