IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESSコントロール コード

  • [アーティクル]

現在の AC および DC バックライト のレベルを設定します。

この操作を実行するには、次のパラメーターを使用して DeviceIoControl 関数を呼び出します。

BOOL DeviceIoControl(
  (HANDLE) hDevice,            // handle to device
  IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS, // dwIoControlCode
  (LPVOID) lpInBuffer,         // input buffer
  (DWORD) nInBufferSize,       // size of the input buffer
  NULL,                        // lpOutBuffer
  0,                           // nOutBufferSize 
  (LPDWORD) lpBytesReturned,   // number of bytes returned
  (LPOVERLAPPED) lpOverlapped  // OVERLAPPED structure
);

パラメーター

hDevice

\\.\LCD デバイスへのハンドル。 デバイス ハンドルを取得するには、 CreateFile 関数を呼び出します。

dwIoControlCode

操作の制御コード。 この値は、実行する特定の操作と、実行するデバイスの種類を識別します。 この操作 にはIOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS を使用します。

lpInBuffer

DISPLAY_BRIGHTNESS構造体へのポインター。

nInBufferSize

lpOutBuffer が指すバッファーのサイズ (バイト単位)。

lpOutBuffer

この操作では使用されません。 を NULL に設定します。

nOutBufferSize

この操作では使用されません。を 0 に設定します。

lpBytesReturned

出力バッファー内の 関数によって返された実際のバイト数を受け取る変数へのポインター。

lpOverlapped が NULL (非オーバーラップ I/O) の場合、lpBytesReturned は内部的に使用され、NULL にすることはできません。

lpOverlapped が NULL (重複 I/O) でない場合、lpBytesReturned は NULL にすることができます。

lpOverlapped

OVERLAPPED 構造体へのポインター。

hDevice が FILE_FLAG_OVERLAPPED フラグで開かれた場合、lpOverlapped は有効な OVERLAPPED 構造体を指す必要があります。 この場合、操作は重複 (非同期) 操作として実行されます。 デバイスが FILE_FLAG_OVERLAPPED フラグを使用して開き、 lpOverlapped が NULL の場合、関数は予期しない方法で失敗します。

FILE_FLAG_OVERLAPPED フラグを指定せずに hDevice を開いた場合、 lpOverlapped は無視され、操作が完了するまで、またはエラーが発生するまで DeviceIoControl は戻りません。

戻り値

操作が正常に完了すると、 DeviceIoControl は 0 以外の値を返します。

操作が失敗した場合、または保留中の場合、 DeviceIoControl は 0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

注釈

DISPLAY_BRIGHTNESS構造体の ucACBrightness および ucDCBrightness メンバーで指定された値は、IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESSによって以前に返されている必要があります。 たとえば、サポートされている値が 10、20、30、40、50、60、70、80、90、100 の場合、値 33 を使用するとエラーになります。

この機能を含むアプリケーションのビルドに使用されるヘッダー ファイル Ntddvdeo.h は、Microsoft Windows Driver Development Kit (DDK) に含まれています。 DDK の取得方法については、「」を参照してください https://www.microsoft.com/whdc/devtools/ddk/default.mspx。

または、次のようにこのコントロール コードを定義できます。

#define IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS \
  CTL_CODE(FILE_DEVICE_VIDEO, 0x127, METHOD_BUFFERED, FILE_ANY_ACCESS)

要件

要件 値
サポートされている最小のクライアント
 Windows Vista、SP1 を使用した Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
Header
Ntddvdeo.h

こちらもご覧ください

バックライト制御インターフェイス

DeviceIoControl

DISPLAY_BRIGHTNESS

IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS

IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS