Guía de implementación de la interfaz

En esta sección se proporcionan instrucciones para la implementación de la interfaz.

En esta sección

Tema	Descripción
Interfaces disponibles y API relacionadas	Hay tres interfaces GPIO: una para cada dispositivo. Un GUID hace referencia a cada interfaz.
Implementación del indicador	En este tema se describe la implementación del indicador.
Implementación de botones	Se recomienda usar un recurso GPIO físico para los botones y los indicadores de estado.

Estado del sistema

El estado predeterminado de todos los botones admitidos por el controlador de bandeja de entrada en la carga está en la posición UP.

La primera indicación mediante el uso de la interfaz alterna el botón especificado (por índice) a un estado down.

El estado predeterminado del indicador de modo portátil/pizarra es SLATE.

El estado predeterminado del indicador de modo acoplado es UNDOCKED.

La primera indicación mediante el uso de la interfaz alternó el indicador al otro estado.

Para consultar el estado, puede usar GetSystemMetric API de la siguiente manera:

int WINAPI GetSystemMetrics(
  _In_  int nIndex
);

Parámetros que están disponibles para los indicadores:

• SM_SYSTEMDOCKED para el estado de acoplamiento. La llamada devuelve 0 para el modo desacopado y distinto de cero en caso contrario.
• SM_CONVERTIBLESLATEMODE para el modo de pizarra. En caso contrario, la llamada devuelve 0 para el modo de pizarra y distinto de cero.

Notificaciones

Cuando cambia la métrica del sistema SM_CONVERTIBLESLATEMODE o SM_SYSTEMDOCKED, el sistema envía un mensaje de difusión mediante WM_SETTINGCHANGE.

El LPARAM del mensaje de WM_SETTINGCHANGE indica qué métrica del sistema ha cambiado mediante una cadena de "ConvertibleSlateMode" o "SystemDockMode".