Función D3DKMTSetDisplayMode (d3dkmthk.h)

La función D3DKMTSetDisplayMode establece la asignación que se usa para examinar la pantalla.

Sintaxis

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

Parámetros

[in, out] unnamedParam1

Puntero a una estructura D3DKMT_SETDISPLAYMODE que describe la asignación que se usa para examinar.

Valor devuelto

D3DKMTSetDisplayMode devuelve uno de los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	El modo de visualización se estableció correctamente.
STATUS_DEVICE_REMOVED	El adaptador de gráficos se detuvo o se restableció el dispositivo de pantalla.
STATUS_INVALID_PARAMETER	Los parámetros se validaron y determinaron que son incorrectos.
STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER	Antes de la llamada a D3DKMTSetDisplayMode, el dispositivo no adquirió la propiedad exclusiva de la vista. Por lo tanto, el dispositivo no pudo establecer el modo de visualización.
D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT	El controlador de cliente instalable (ICD) openGL debe convertir el formato de la superficie asociada a la asignación que especifica el miembro hPrimaryAllocation de hPrimaryAllocation de D3DKMT_SETDISPLAYMODE en el atributo de formato que especifica el PrivateDriverFormatAttribute miembro de D3DKMT_SETDISPLAYMODE. A continuación, el ICD debe llamar a D3DKMTSetDisplayMode de nuevo. El ICD podría asignar una nueva asignación, realizar una transferencia de bloque de bits de conversión (bitblt) desde la base de datos principal antigua a la nueva y, a continuación, destruir la principal antigua siempre que el ICD use el nuevo identificador de asignación para esta asignación para todas las operaciones posteriores. El ICD debe repetir este proceso hasta que D3DKMTSetDisplayMode devuelva un valor devuelto diferente.

Esta función también puede devolver otros valores de NTSTATUS.

Observaciones

Antes de que openGL ICD llame D3DKMTSetDisplayMode para establecer un nuevo modo de presentación que use un formato extendido, un método de muestreo múltiple o ambos, el ICD debe asegurarse de que el modo de presentación GDI actual tenga la misma resolución que el nuevo modo de presentación. De lo contrario, D3DKMTSetDisplayMode devuelve STATUS_INVALID_PARAMETER.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
de la plataforma de destino de	Universal
encabezado de	d3dkmthk.h (incluya D3dkmthk.h)
biblioteca de	Gdi32.lib
DLL de	Gdi32.dll

Consulte también

D3DKMT_SETDISPLAYMODE