Função D3DKMTSetDisplayMode (d3dkmthk.h)

A função D3DKMTSetDisplayMode define a alocação usada para verificar a exibição.

Sintaxe

NTSTATUS D3DKMTSetDisplayMode(
  [in, out] const D3DKMT_SETDISPLAYMODE *unnamedParam1
);

Parâmetros

[in, out] unnamedParam1

Um ponteiro para uma estrutura D3DKMT_SETDISPLAYMODE que descreve a alocação usada para verificar.

Retornar valor

D3DKMTSetDisplayMode retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	O modo de exibição foi definido com êxito.
STATUS_DEVICE_REMOVED	O adaptador gráfico foi interrompido ou o dispositivo de exibição foi redefinido.
STATUS_INVALID_PARAMETER	Os parâmetros foram validados e determinados como incorretos.
STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER	Antes da chamada para D3DKMTSetDisplayMode, o dispositivo não adquiriu a propriedade exclusiva do modo de exibição. Portanto, o dispositivo não pôde definir o modo de exibição.
D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT	O ICD (driver de cliente instalável) do OpenGL deve converter o formato da superfície associada à alocação que o membro hPrimaryAllocation de D3DKMT_SETDISPLAYMODE especifica no atributo de formato que o membro PrivateDriverFormatAttribute de D3DKMT_SETDISPLAYMODE especifica. O ICD deve chamar D3DKMTSetDisplayMode novamente. O ICD pode alocar uma nova alocação, executar uma conversão de bit-block transfer (bitblt) do primário antigo para o novo e, em seguida, destruir o primário antigo, desde que o ICD use o novo identificador de alocação para essa alocação para todas as operações subsequentes. O ICD deve repetir esse processo até que D3DKMTSetDisplayMode retorne um valor retornado diferente.

Essa função também pode retornar outros valores NTSTATUS .

Comentários

Antes que o OpenGL ICD chame D3DKMTSetDisplayMode para definir um novo modo de exibição que usa um formato estendido, um método de amostragem múltipla ou ambos, o ICD deve garantir que o modo de exibição GDI atual tenha a mesma resolução que o novo modo de exibição. Caso contrário, D3DKMTSetDisplayMode retornará STATUS_INVALID_PARAMETER.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Plataforma de Destino	Universal
Cabeçalho	d3dkmthk.h (inclua D3dkmthk.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll

Confira também

D3DKMT_SETDISPLAYMODE