DXGKDDI_SETPOINTERPOSITION función de devolución de llamada (d3dkmddi.h)
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 minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de Microsoft DirectX en la función MiniportDeviceContext parámetro de salida del DxgkDdiAddDevice.
[in] pSetPointerPosition
Puntero a una estructura 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.
Observaciones
El subsistema del kernel de gráficos directX llama a la función dxgkDdiSetPointer Position del controlador de miniport para mostrar 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 de DxgkDdiSetPointerPosition puede ejecutarse simultáneamente con otro subproceso de controlador de miniporte de pantalla. Sin embargo, el sistema garantiza que dxgkDdiSetPointerPosition y dxgkDdiSetPointerShape subprocesos no se pueden ejecutar simultáneamente.
Si ejecuta un subproceso de DxgkDdiSetPointerPosition subproceso de controlador de miniporte de pantalla simultáneamente con otro subproceso de controlador de miniporte de pantalla, el controlador de minipuerto de pantalla debe poder programar el hardware de 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 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 incluso si la topología de red (VidPN) de vídeo presente que está asociada a la VidPnSourceId miembro de la estructura de 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 ningún cambio en el estado del controlador o hardware.
dxgkDdiSetPointerPosition debe ser paginable.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h (incluya D3dkmddi.h) |
| irQL | PASSIVE_LEVEL |