DXGKARG_SETPOINTERSHAPE estrutura (d3dkmddi.h)

Artigo
02/06/2025

A estrutura DXGKARG_SETPOINTERSHAPE descreve a aparência do ponteiro do mouse e o local em que ele deve ser exibido.

Sintaxe

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;

Membros

[in] Flags

Uma estrutura DXGK_POINTERFLAGS que identifica, em sinalizadores de campo de bit, como exibir o ponteiro do mouse.

[in] Width

A largura do ponteiro do mouse, em pixels.

[in] Height

A altura do ponteiro do mouse, em linhas de verificação.

[in] Pitch

A largura do ponteiro do mouse, em bytes.

[in] VidPnSourceId

O número de identificação baseado em zero do vídeo que apresenta a origem em um caminho de uma topologia VidPN (rede de apresentação de vídeo) na qual o ponteiro do mouse está localizado.

[in] pPixels

Um ponteiro para o início do bitmap a seguir, dependendo do sinalizador de campo de bits definido no membro sinalizadores do:

Sinalizador de campo de bit	Mapa de bits
Monocromático	Para ponteiros de mouse monocromáticos: Um bitmap monocromático cujo tamanho é especificado por Width e Height em uma máscara AND de formato DIB de 1 bits por pixel (bpp) seguida por outra máscara XOR de formato DIB de 1 bpp do mesmo tamanho.
Cor	Para ponteiros de mouse de cor: Um bitmap de cor cujo tamanho é especificado por Width e Height em um formato DIB (bitmap independente) do dispositivo ARGB de 32 bpp.
MaskedColor	Para ponteiros de mouse de cor mascarada: Um bitmap de formato ARGB de 32 bpp com o valor da máscara nos bits alfa. Os únicos valores de máscara permitidos são 0 e 0xFF. Quando o valor da máscara for 0, o valor RGB deverá substituir o pixel de tela. Quando o valor da máscara é 0xFF, uma operação XOR é executada no valor RGB e no pixel de tela; o resultado deve substituir o pixel de tela.

[in] XHot

A coluna, em pixels, na qual o ponteiro do mouse está localizado no canto superior esquerdo do bitmap que pPixels aponta.

[in] YHot

A linha, em pixels, na qual o ponteiro do mouse está localizado no canto superior esquerdo do bitmap que pPixels aponta.

Observações

Os membros XHot e YHot são usados por drivers de miniporto de exibição que não estão associados ao hardware e esses membros podem ser ignorados por drivers que controlam o hardware.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
cabeçalho	d3dkmddi.h (inclua D3dkmddi.h)

Consulte também

DXGK_POINTERFLAGS

DxgkDdiSetPointerShape

Compartilhar via