Método IDXGIOutput1::GetDisplayModeList1 (dxgi1_2.h)
Obtiene los modos de presentación que coinciden con el formato solicitado y otras opciones de entrada.
Sintaxis
HRESULT GetDisplayModeList1(
DXGI_FORMAT EnumFormat,
UINT Flags,
[in, out] UINT *pNumModes,
[out, optional] DXGI_MODE_DESC1 *pDesc
);
Parámetros
EnumFormat
Valor DXGI_FORMAT con tipo para el formato de color.
Flags
Combinación de valores con tipo DXGI_ENUM_MODES que se combinan mediante una operación OR bit a bit. El valor resultante especifica opciones para los modos de presentación que se van a incluir. Debe especificar DXGI_ENUM_MODES_SCALING para exponer los modos de visualización que requieren escalado. Los modos centrados que no requieren escalado y se corresponden directamente con la salida de la pantalla se enumeran de forma predeterminada.
[in, out] pNumModes
Puntero a una variable que recibe el número de modos de visualización que GetDisplayModeList1 devuelve en el bloque de memoria al que apunta pDesc . Establezca pDesc en NULL para que pNumModes devuelva el número de modos de presentación que coinciden con el formato y las opciones. De lo contrario, pNumModes devuelve el número de modos de presentación devueltos en pDesc.
[out, optional] pDesc
Puntero a una lista de modos de visualización; establezca en NULL para obtener el número de modos de presentación.
Valor devuelto
Devuelve uno de los códigos de error descritos en el tema DXGI_ERROR . Es poco frecuente, pero posible, que los modos de visualización disponibles pueden cambiar inmediatamente después de llamar a este método, en cuyo caso se devuelve DXGI_ERROR_MORE_DATA (si no hay suficiente espacio para todos los modos de visualización).
Comentarios
GetDisplayModeList1 se actualiza desde GetDisplayModeList para devolver una lista de estructuras de DXGI_MODE_DESC1 , que son descripciones de modo actualizadas. GetDisplayModeList se comporta como si llamara a GetDisplayModeList1 porque GetDisplayModeList puede devolver todos los modos especificados por DXGI_ENUM_MODES, incluido el modo estéreo. Sin embargo, GetDisplayModeList devuelve una lista de estructuras de DXGI_MODE_DESC , que son las descripciones del modo anterior y no indican el modo estéreo.
El método GetDisplayModeList1 no enumera los modos estéreo a menos que especifique la marca DXGI_ENUM_MODES_STEREO en el parámetro Flags . Si especifica DXGI_ENUM_MODES_STEREO, los modos estéreo se incluyen en la lista de modos devueltos a los que apunta el parámetro pDesc . En otras palabras, el método devuelve los modos estéreo y mono.
En general, al cambiar del modo de ventana a pantalla completa, una cadena de intercambio elige automáticamente un modo de visualización que cumple (o supera) la resolución, la profundidad de color y la velocidad de actualización de la cadena de intercambio. Para ejercer más control sobre el modo de visualización, use GetDisplayModeList1 para sondear el conjunto de modos de visualización que se validan con las funcionalidades de supervisión o todos los modos que coincidan con el escritorio (si la configuración de escritorio no se valida con el monitor).
En el código de ejemplo siguiente se muestra que necesita llamar a GetDisplayModeList1 dos veces. En primer lugar, llame a GetDisplayModeList1 para obtener el número de modos disponibles y, en segundo lugar, llame a GetDisplayModeList1 para devolver una descripción de los modos.
UINT num = 0;
DXGI_FORMAT format = DXGI_FORMAT_R32G32B32A32_FLOAT;
UINT flags = DXGI_ENUM_MODES_INTERLACED;
pOutput->GetDisplayModeList1( format, flags, &num, 0);
...
DXGI_MODE_DESC1 * pDescs = new DXGI_MODE_DESC1[num];
pOutput->GetDisplayModeList1( format, flags, &num, pDescs);
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 y Actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | dxgi1_2.h |
| Library | DXGI.lib |