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

Artículo
02/26/2024

La función DxgkDdiSetPointerPosition establece el estado de ubicación y visibilidad del puntero del mouse.

Sintaxis

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

NTSTATUS DxgkddiSetpointerposition(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERPOSITION pSetPointerPosition
)
{...}

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

[in] pSetPointerPosition

Puntero a una estructura de DXGKARG_SETPOINTERPOSITION que describe dónde y cómo mostrar el puntero del mouse.

Valor devuelto

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

Comentarios

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

Si ejecuta un subproceso DxgkDdiSetPointerPosition simultáneamente con otro subproceso de controlador de miniporte de pantalla, el controlador de miniporte 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 a memoria (MMIO), y así sucesivamente.

Se puede llamar a DxgkDdiSetPointerPosition aunque la topología de red (VidPN) de vídeo presente esté asociada al miembro VidPnSourceId de la estructura DXGKARG_SETPOINTERPOSITION a la que apunta el parámetro pSetPointerPosition está deshabilitado. En este caso, el controlador debe devolver STATUS_SUCCESS, pero no debe realizar cambios en el estado del controlador o hardware.

DxgkDdiSetPointerPosition debe ser paginable.