DXGKDDI_SETPOINTERPOSITION fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction DxgkDdiSetPointerPosition définit l’emplacement et l’état de visibilité du pointeur de la souris.

Syntaxe

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

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

Paramètres

[in] hAdapter

Handle vers un bloc de contexte associé à un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique Microsoft DirectX dans le MiniportDeviceContext paramètre de sortie de la fonction DxgkDdiAddDevice.

[in] pSetPointerPosition

Pointeur vers une structure DXGKARG_SETPOINTERPOSITION qui décrit où et comment afficher le pointeur de la souris.

Valeur de retour

DxgkDdiSetPointerPosition retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Le sous-système du noyau graphique DirectX appelle la fonction d'du pilote miniport d’affichage DxgkDdiSetPointerPosition pour définir l’emplacement du pointeur de la souris. La fonction DxgkDdiSetPointerPosition est appelée indépendamment de toutes les autres fonctions de pilote miniport d’affichage. Par conséquent, un thread DxgkDdiSetPointerPosition peut s’exécuter simultanément avec un autre thread de pilote miniport d’affichage. Toutefois, le système garantit que threads DxgkDdiSetPointerPosition et DxgkDdiSetPointerShape ne peuvent pas s’exécuter simultanément.

Si vous exécutez un thread DxgkDdiSetPointerPosition thread simultanément avec un autre thread de pilote miniport d’affichage, le pilote de miniport d’affichage doit être en mesure de programmer le matériel du pointeur de souris indépendamment d’autres activités, telles que les opérations qui envoient une mémoire tampon par le biais d’un accès direct à la mémoire (DMA) au matériel graphique, opérations qui programment le matériel graphique à l’aide d’E/S mappées en mémoire (MMIO), et ainsi de suite.

DxgkDdiSetPointerPosition peut être appelée même si la topologie de réseau présent (VidPN) associée à la topologie VidPnSourceId membre de la structure DXGKARG_SETPOINTERPOSITION sur laquelle le paramètre pSetPointerPosition points de paramètres est désactivé. Dans ce cas, le pilote doit retourner STATUS_SUCCESS mais ne doit apporter aucune modification à l’état du pilote ou du matériel.

DxgkDdiSetPointerPosition doit être rendu paginable.