DXGKDDI_SETPOINTERSHAPE fonction de rappel (d3dkmddi.h)

Article
02/23/2024

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 paramètre de sortie MiniportDeviceContext 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 retournée

DxgkDdiSetPointerShape retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	Le pointeur de la souris est correctement dessiné.
STATUS_NO_MEMORY	DxgkDdiSetPointerShape n’a pas pu allouer la mémoire nécessaire pour qu’il 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 de 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 les threads DxgkDdiSetPointerShape et DxgkDdiSetPointerPosition ne peuvent pas s’exécuter simultanément.

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

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

DxgkDdiSetPointerShape doit être rendu paginable.