structure DXGKARG_SETPOINTERSHAPE (d3dkmddi.h)

Article
02/26/2024

La structure DXGKARG_SETPOINTERSHAPE décrit l’apparence du pointeur de la souris et l’emplacement dans lequel il doit être affiché.

Syntaxe

typedef struct _DXGKARG_SETPOINTERSHAPE {
  [in] DXGK_POINTERFLAGS              Flags;
  [in] UINT                           Width;
  [in] UINT                           Height;
  [in] UINT                           Pitch;
  [in] D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  [in] const VOID                     *pPixels;
  [in] UINT                           XHot;
  [in] UINT                           YHot;
} DXGKARG_SETPOINTERSHAPE;

Membres

[in] Flags

Une structure DXGK_POINTERFLAGS qui identifie, dans les indicateurs de champ binaire, comment afficher le pointeur de la souris.

[in] Width

Largeur du pointeur de la souris, en pixels.

[in] Height

Hauteur du pointeur de la souris, en lignes d’analyse.

[in] Pitch

Largeur du pointeur de la souris, en octets.

[in] VidPnSourceId

Numéro d’identification de base zéro de la source présente de la vidéo dans un chemin d’accès d’une topologie de réseau vidéo présent (VidPN) dans laquelle se trouve le pointeur de la souris.

[in] pPixels

Pointeur vers le début de l’image bitmap suivante en fonction de l’indicateur de champ de bits défini dans le membre Indicateurs :

Indicateur de champ de bits	Bitmap
Monochrome	Pour les pointeurs de souris monochromes : Bitmap monochrome dont la taille est spécifiée par Width et Height dans un format DIB de 1 bits par pixel (bpp) et un masque qui est suivi d’un autre masque XOR au format DIB 1 bpp de la même taille.
Couleur	Pour les pointeurs de souris de couleur : Bitmap de couleur dont la taille est spécifiée par Width et Height dans un format bitmap indépendant d’appareil (DIB) 32 bpp ARGB.
MaskedColor	Pour les pointeurs de souris de couleur masqués : Bitmap au format ARGB 32 bpp avec la valeur de masque dans les bits alpha. Les seules valeurs de masque autorisées sont 0 et 0xFF. Lorsque la valeur du masque est 0, la valeur RVB doit remplacer le pixel de l’écran. Lorsque la valeur du masque est 0xFF, une opération XOR est effectuée sur la valeur RVB et le pixel de l’écran ; le résultat doit remplacer le pixel de l’écran.

[in] XHot

Colonne, en pixels, sur laquelle le pointeur de la souris se trouve en haut à gauche de la bitmap vers laquelle pPixels pointe.

[in] YHot

Ligne, en pixels, sur laquelle le pointeur de la souris se trouve en haut à gauche de l’image bitmap vers laquelle pPixels pointe.

Remarques

Les membres XHot et YHot sont utilisés par les pilotes miniport d’affichage qui ne sont pas associés au matériel, et ces membres peuvent être ignorés par les pilotes qui contrôlent le matériel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
En-tête	d3dkmddi.h (inclure D3dkmddi.h)

Voir aussi

DXGK_POINTERFLAGS

DxgkDdiSetPointerShape

Partager via