PFND3DDDI_SETDISPLAYMODE função de retorno de chamada (d3dumddi.h)

  • Artigo

A função SetDisplayMode muda para um modo de exibição ou primário que não é compatível com a área de trabalho GDI.

Sintaxe

PFND3DDDI_SETDISPLAYMODE Pfnd3dddiSetdisplaymode;

HRESULT Pfnd3dddiSetdisplaymode(
  HANDLE hDevice,
  const D3DDDIARG_SETDISPLAYMODE *unnamedParam2
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

unnamedParam2

pData [in]

Um ponteiro para uma estrutura D3DDDIARG_SETDISPLAYMODE que especifica parâmetros para definir o modo de exibição.

Retornar valor

SetDisplayMode retornará S_OK ou um resultado de erro apropriado se o modo de exibição não for definido com êxito.

Comentários

O runtime do Microsoft Direct3D chama SetDisplayMode para alternar para um modo de exibição ou primário que não é compatível com a área de trabalho GDI. A lista a seguir descreve exemplos dessas primárias:

  • Primárias criadas com formatos de destino de 10 bits por canal (10:10:10:2) exibem e renderizam formatos de destino (por exemplo, D3DFMT_A2R10G10B10)
  • Primárias de vários exemplos em que a amostragem múltipla é executada durante a verificação
  • Primárias persistentes que são usadas por aplicativos microsoft directx versão 9.L de tela inteira
O runtime do Direct3D chama a função CreateResource do driver de exibição do modo de usuário para criar o primário a ser verificado. No entanto, o driver deve programar o hardware para verificar somente quando sua função SetDisplayMode for chamada. Portanto, o runtime define os membros hResource e SubResourceIndex da estrutura D3DDDIARG_SETDISPLAYMODE que é apontada pelo parâmetro pData para o primário que foi criado por meio da chamada para a função CreateResource do driver. Em seguida, o driver deve traduzir o primário representado por hResource e SubResourceIndex para um identificador de alocação primário. Depois que o driver fizer essa tradução, o driver deverá passar o identificador resultante em uma chamada para a função pfnSetDisplayModeCb , que inicia uma chamada para a função DxgkDdiCommitVidPn do driver de miniport.

O driver de exibição do modo de usuário pode definir o membro hPrimaryAllocation da estrutura D3DDDICB_SETDISPLAYMODE na chamada para pfnSetDisplayModeCb para verificar qualquer alocação. No entanto, a alocação deve ser marcada como primária (ou seja, o driver de exibição do modo de usuário deve ter definido o sinalizador de campo de bit primário no membro Flags da estrutura D3DDDI_ALLOCATIONINFO em uma chamada para a função pfnAllocateCb para criar a alocação).

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho d3dumddi.h (inclua D3dumddi.h)

Confira também

D3DDDIARG_SETDISPLAYMODE

D3DDDI_DEVICEFUNCS

pfnSetDisplayModeCb