インターフェイス実装ガイダンス

このセクションでは、インターフェイスの実装に関するガイダンスを提供します。

このセクションの内容

トピック 説明

使用できるインターフェイスと関連する API

3 つの GPIO インターフェイス (各デバイスに 1 つずつ) があります。 各インターフェイスは GUID によって参照されます。

インジケーターの実装

このトピックでは、インジケーターの実装について説明します。

ボタンの実装

ボタンと状態インジケーターの両方に物理 GPIO リソースを使用することをお勧めします。

システム状態

読み込み時に受信トレイ ドライバーでサポートされているすべてのボタンの既定の状態は、UP 位置です。

インターフェイスを使用した最初の表示により、指定したボタン (インデックスによる) が DOWN の状態に切り替わりました。

ノート PC/スレート モード インジケーターの既定の状態はスレートです。

ドッキング モード インジケーターの既定の状態はドッキング解除です。

インターフェイスを使用した最初の表示により、インジケーターがもう一方の状態に切り替わりました。

状態のクエリを実行するには、GetSystemMetric API を次のように使用します。

int WINAPI GetSystemMetrics(
  _In_  int nIndex
);

インジケーターに使用できるパラメーター:

  • SM_SYSTEMDOCKED (ドッキング状態の確認)。 この呼び出しでは、ドッキング解除モードの場合は 0 が返され、それ以外の場合は 0 以外の値が返されます。
  • SM_CONVERTIBLESLATEMODE (スレート モードの確認)。 この呼び出しでは、スレート モードの場合は 0 が返され、それ以外の場合は 0 以外の値が返されます。

通知

システム メトリック SM_CONVERTIBLESLATEMODE または SM_SYSTEMDOCKED のいずれかが変更されると、システムが WM_SETTINGCHANGE を使用してブロードキャスト メッセージを送信します。

WM_SETTINGCHANGE メッセージの LPARAM は、"ConvertibleSlateMode" または "SystemDockMode" のいずれかの文字列を使用して、どのシステム メトリックが変更されたかを示します。