NLED_SETTINGS_INFO (Windows Embedded CE 6.0)

1/6/2010

This structure contains information about the capabilities of the specified LED.

Syntax

struct NLED_SETTINGS_INFO {
  UINT LedNum;
  INT OffOnBlink;
  LONG TotalCycleTime;
  LONG OnTime;
  LONG OffTime;
  INT MetaCycleOn;
  INT MetaCycleOff; 
};

Members

  • LedNum
    LED number. The first LED is zero (0).
  • OffOnBlink
    Current setting. The following table shows the defined values.

    Value Description

    0

    Off

    1

    On

    2

    Blink

  • TotalCycleTime
    Total cycle time of a blink, in microseconds.
  • OnTime
    On time of the cycle, in microseconds.
  • OffTime
    Off time of the cycle, in microseconds.
  • MetaCycleOn
    Number of on blink cycles.
  • MetaCycleOff
    Number of off blink cycles.

Remarks

The NLedGetDeviceInfo and NLedSetDevice functions use this structure.

The caller should first get the number of notification LEDs on the system. This is usually 1 but may be zero (0) and could be greater than 1. The caller should fill in Lednum and then call NLedDriverGetDeviceInfo. LED numbering starts at zero (0).

The hardware may have some minimum on or off time, so setting the OnTime or OffTime fields to zero (0) may still result in a non-zero on or off time.

The information related to blinking in the NLED_SETTINGS_INFO structure is only relevant if the OffOnBlink field is set to 2 (blink). The driver will not make any checks on the blinking related fields of the structure otherwise.

Requirements

Header nled.h
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

Notification LED Driver Structures
NLedDriverGetDeviceInfo
NLedGetDeviceInfo
NLedSetDevice