Función D3DKMTGetDisplayModeList (d3dkmthk.h)
La función D3DKMTGetDisplayModeList recupera una lista de modos de visualización disponibles, incluidos los modos con formato extendido.
Sintaxis
NTSTATUS D3DKMTGetDisplayModeList(
D3DKMT_GETDISPLAYMODELIST *unnamedParam1
);
Parámetros
unnamedParam1
[in/out] pData es un puntero a una estructura D3DKMT_GETDISPLAYMODELIST que contiene los argumentos de esta función.
Valor devuelto
D3DKMTGetDisplayModeList devuelve un valor de NTSTATUS como uno de los siguientes.
| código de retorno | descripción |
|---|---|
| STATUS_SUCCESS | La lista de modos de visualización disponibles se recuperó correctamente o el número de modos de presentación se devolvió en pData->ModeCount si pData->pModeList era NULL y pData->ModeCount era cero en la entrada. |
| STATUS_DEVICE_REMOVED | El adaptador de gráficos se detuvo. |
| STATUS_BUFFER_TOO_SMALL | El búfer que el controlador de cliente proporcionó en pData->pModeList no es lo suficientemente grande como para contener la lista de modo de presentación solicitada. |
| STATUS_GRAPHICS_NO_AVAILABLE_VIDPN_TARGET | No hay ningún destino de vídeo presente disponible para su uso con el origen de la presentación de vídeo identificado por pData->VidPnSourceId. Por lo tanto, no hay ningún modo de visualización disponible para este origen. |
| STATUS_INVALID_PARAMETER** | Los parámetros se validaron y determinaron que son incorrectos. |
Observaciones
Para obtener el número de modos de visualización para el origen vidPn especificado (pData->VidPnSourceId) en el adaptador de gráficos (pData->hAdapter), un controlador cliente puede llame a D3DKMTGetDisplayModeList con pData->pModeList establecido en NULL y pData->ModeCount como 0. Si esta llamada devuelve STATUS_SUCCESS, el pData->ModeCount es el número total de los modos de presentación. A continuación, el controlador cliente puede asignar una matriz de estructuras
Los atributos para mostrar del origen VidPn especificado se pueden cambiar entre estas dos llamadas, lo que hace que se cambie la lista de modo de presentación. En este caso, si la matriz de D3DKMT_DISPLAYMODE proporcionada por el autor de la llamada no es lo suficientemente grande como para contener la nueva lista de modos de presentación, esta función devolverá STATUS_BUFFER_TOO_SMALL con el número de los nuevos modos de presentación en la ModeCount devuelta. El autor de la llamada puede liberar la matriz de D3DKMT_DISPLAYMODE anterior, asignar una nueva matriz de D3DKMT_DISPLAYMODE basada en el nuevo número devuelto y llamar a esta función de nuevo con el nuevo número y la nueva matriz de D3DKMT_DISPLAYMODE para obtener la nueva lista de modo de presentación.
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 |