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 |