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 de 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 presentació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 presentación. |
| D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT | El controlador cliente instalable (ICD) de OpenGL debe convertir el formato de la superficie asociada a la asignación que el miembro hPrimaryAllocation de D3DKMT_SETDISPLAYMODE especifica en el atributo de formato que especifica el miembro PrivateDriverFormatAttribute de D3DKMT_SETDISPLAYMODE . Después, 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 anterior a la nueva y, a continuación, destruir la base de datos principal anterior siempre y cuando 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 podría devolver otros valores NTSTATUS .
Comentarios
Antes de que openGL ICD llame a 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 | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Universal |
| Encabezado | d3dkmthk.h (incluya D3dkmthk.h) |
| Library | Gdi32.lib |
| Archivo DLL | Gdi32.dll |