struttura DXGKARG_SETPOINTERSHAPE (d3dkmddi.h)

Articolo
02/06/2025

La struttura DXGKARG_SETPOINTERSHAPE descrive l'aspetto del puntatore del mouse e la posizione in cui deve essere visualizzata.

Sintassi

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;

Membri

[in] Flags

Struttura DXGK_POINTERFLAGS che identifica, in flag di campo di bit, come visualizzare il puntatore del mouse.

[in] Width

Larghezza del puntatore del mouse, espressa in pixel.

[in] Height

Altezza del puntatore del mouse, nelle linee di analisi.

[in] Pitch

Larghezza del puntatore del mouse, espressa in byte.

[in] VidPnSourceId

Numero di identificazione in base zero dell'origine video presente in un percorso di una topologia di rete (VidPN) presente nel video in cui si trova il puntatore del mouse.

[in] pPixels

Puntatore all'inizio della bitmap seguente a seconda del flag di campo di bit impostato nel membro Flag:

Flag campo di bit	Bitmap
Monocromatico	Per i puntatori del mouse monocromatici: Bitmap monocromatica le cui dimensioni sono specificate da Width e Height in un formato E maschera DIB a 1 bit per pixel (bpp) seguito da un'altra maschera XOR in formato DIB a 1 bpp della stessa dimensione.
Colore	Per i puntatori del mouse a colori: Bitmap di colore le cui dimensioni sono specificate da Width e Height in un formato bitmap indipendente dal dispositivo ARGB (DIB) di 32 bpp.
MaskedColor	Per i puntatori del mouse a colori mascherati: Bitmap in formato ARGB a 32 bpp con il valore mask nei bit alfa. Gli unici valori mask consentiti sono 0 e 0xFF. Quando il valore della maschera è 0, il valore RGB deve sostituire il pixel dello schermo. Quando il valore della maschera è 0xFF, viene eseguita un'operazione XOR sul valore RGB e sul pixel dello schermo; il risultato deve sostituire il pixel dello schermo.

[in] XHot

Colonna, in pixel, su cui si trova il puntatore del mouse dall'alto a sinistra della bitmap a cui pPixels punta.

[in] YHot

Riga, in pixel, su cui si trova il puntatore del mouse dall'alto a sinistra della bitmap a cui pPixels punta.

Osservazioni

I membri XHot e YHot vengono utilizzati dai driver miniport visualizzati che non sono associati all'hardware e questi membri possono essere ignorati dai driver che controllano l'hardware.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
intestazione	d3dkmddi.h (include D3dkmddi.h)

Vedere anche

DXGK_POINTERFLAGS

DxgkDdiSetPointerShape

Condividi tramite