DXGKDDI_SETPOINTERPOSITION fonction de rappel (d3dkmddi.h)

  • Article

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 paramètre de sortie MiniportDeviceContext de la fonction DxgkDdiAddDevice .

[in] pSetPointerPosition

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

Valeur retournée

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 DxgkDdiSetPointerPosition du pilote miniport d’affichage 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 de 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 les threads DxgkDdiSetPointerPosition et DxgkDdiSetPointerShape ne peuvent pas s’exécuter simultanément.

Si vous exécutez un thread DxgkDdiSetPointerPosition simultanément avec un autre thread de pilote de miniport d’affichage, le pilote de miniport d’affichage doit être en mesure de programmer le matériel de pointeur de souris indépendamment d’autres activités, telles que les opérations qui envoient une mémoire tampon de commande via l’accès direct à la mémoire (DMA) au matériel graphique, les 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é même si la topologie de réseau présent vidéo (VidPN) associée au membre VidPnSourceId de la structure DXGKARG_SETPOINTERPOSITION vers laquelle pointe le paramètre pSetPointerPosition est désactivée. 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dkmddi.h (include D3dkmddi.h)
IRQL PASSIVE_LEVEL

Voir aussi

DXGKARG_SETPOINTERPOSITION

DxgkDdiAddDevice

DxgkDdiSetPointerShape