DXGKDDI_SETPOINTERSHAPE fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction DxgkDdiSetPointerShape définit l’apparence et l’emplacement du pointeur de la souris.

Syntaxe

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

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

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

Pointeur vers une structure DXGKARG_SETPOINTERSHAPE qui décrit l’apparence et l’emplacement du pointeur de la souris.

Valeur de retour

DxgkDdiSetPointerShape retourne l’une des valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	Le pointeur de la souris est correctement dessiné.
STATUS_NO_MEMORY	DxgkDdiSetPointerShape n’a pas pu allouer de mémoire nécessaire pour qu’elle se termine.

Remarques

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

Si vous exécutez un thread DxgkDdiSetPointerShape 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.

la topologie DxgkDdiSetPointerShape n’est pas appelée si la topologie de réseau présent (VidPN) associée au membre VidPnSourceId de la structure DXGKARG_SETPOINTERSHAPE à laquelle le paramètre pSetPointerShape est désactivé.

DxgkDdiSetPointerShape doit être rendu paginable.