Skip to content

Commit 7b02d47

Browse files
authored
Update HID reports documentation formatting
Remove duplitate text
1 parent 1af9517 commit 7b02d47

1 file changed

Lines changed: 2 additions & 15 deletions

File tree

windows-driver-docs-pr/hid/interpreting-hid-reports.md

Lines changed: 2 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -46,19 +46,6 @@ After an application or driver uses these routines to obtain information about w
4646
- [HidP_UsageListDifference](/windows-hardware/drivers/ddi/hidpi/nf-hidpi-hidp_usagelistdifference)
4747
- [HidP_UsageAndPageListDifference](/windows-hardware/drivers/ddi/hidpi/nf-hidpi-hidp_usageandpagelistdifference)
4848

49-
## Extracting and setting control data by data indices
50-
51-
To use data indices to extract and set control data in a HID report, an application or driver can use the following [HIDClass support routines](/windows-hardware/drivers/ddi/_hid/#hidclass-support-routines):
52-
53-
- [HidP_GetData](/windows-hardware/drivers/ddi/hidpi/nf-hidpi-hidp_getdata)
54-
- [HidP_SetData](/windows-hardware/drivers/ddi/hidpi/nf-hidpi-hidp_setdata)
55-
56-
These routines are useful to an application or driver that provides a "value-added" service. For example, one that provides a custom interface to all the controls supported by a HIDClass device. Microsoft DirectInput is one example.
57-
58-
An application or driver calling these routines can most efficiently obtain and set all values in a report. For example, to obtain all value data by their [HID usages](./hid-usages.md) it has to call [HidP_GetUsageValue](/windows-hardware/drivers/ddi/hidpi/nf-hidpi-hidp_getusagevalue) for each usage. However, to obtain all value data by data index, it only has to call **HidP_GetData** once.
59-
60-
An application or driver uses the data indices specified in a collection's [Button Capability Arrays](./button-capability-arrays.md) and [Value Capability Arrays](./value-capability-arrays.md) to identify HID usages.
61-
6249
## Setting value data by specifying its usage
6350

6451
An application or driver can set a value in a properly initialized HID report by calling one of the following HID support routines:
@@ -74,7 +61,7 @@ An application or driver can set the state of buttons in a properly initialized
7461
- [HidP_SetButtons](/windows-hardware/drivers/ddi/hidpi/#hidp_setbuttons) (or [HidP_SetUsages](/windows-hardware/drivers/ddi/hidpi/nf-hidpi-hidp_setusages)) Sets a specified set of buttons to ON (1).
7562
- [HidP_UnsetButtons](/windows-hardware/drivers/ddi/hidpi/#hidp_unsetbuttons) (or [HidP_UnsetUsages](/windows-hardware/drivers/ddi/hidpi/nf-hidpi-hidp_unsetusages)) Sets a specified set of buttons to OFF (zero).
7663

77-
## Extracting and setting HID control data by data indices
64+
## Extracting and setting control data by data indices
7865

7966
To use data indices to extract and set control data in a HID report, an application or driver can use the following [HIDClass support routines](/windows-hardware/drivers/ddi/_hid/#hidclass-support-routines):
8067

@@ -83,7 +70,7 @@ To use data indices to extract and set control data in a HID report, an applicat
8370

8471
These routines are useful to an application or driver that provides a "value-added" service. For example, one that provides a custom interface to all the controls supported by a HIDClass device. Microsoft DirectInput is one example.
8572

86-
An application or driver calling these routines can most efficiently obtain and set all values in a report. For example, to obtain all value data by their HID usages, it has to call [HidP_GetUsageValue](/windows-hardware/drivers/ddi/hidpi/nf-hidpi-hidp_getusagevalue) for each usage. However, to obtain all value data by data index, it only has to call **HidP_GetData** once.
73+
An application or driver calling these routines can most efficiently obtain and set all values in a report. For example, to obtain all value data by their [HID usages](./hid-usages.md) it has to call [HidP_GetUsageValue](/windows-hardware/drivers/ddi/hidpi/nf-hidpi-hidp_getusagevalue) for each usage. However, to obtain all value data by data index, it only has to call **HidP_GetData** once.
8774

8875
An application or driver uses the data indices specified in a collection's [Button Capability Arrays](./button-capability-arrays.md) and [Value Capability Arrays](./value-capability-arrays.md) to identify HID usages.
8976

0 commit comments

Comments
 (0)