libusbk-sys 0.2.0

Rust Windows library for accessing USB devices via libusbK
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

/*!********************************************************************
libusbK - kList descriptor diagnostic tool.
Copyright (C) 2012 Travis Lee Robinson. All Rights Reserved.
libusb-win32.sourceforge.net

Development : Travis Lee Robinson  (libusbdotnet@gmail.com)
Testing     : Xiaofan Chen         (xiaofanc@gmail.com)

At the discretion of the user of this library, this software may be
licensed under the terms of the GNU Public License v3 or a BSD-Style
license as outlined in the following files:
* LICENSE-gpl3.txt
* LICENSE-bsd.txt

License files are located in a license folder at the root of source and
binary distributions.
********************************************************************!*/

#ifndef __USBIDS_H_
#define __USBIDS_H_


#include <windows.h>
#include <stdio.h>
#include <stdlib.h>

#define MATCH_END 0xffffffffUL  /* maximum unsigned long value */


extern LPCSTR UsbIdsText;

#ifndef InitUsbIdsContext
#define InitUsbIdsContext(UsbIdsContext,StartTextPtr,PredicateCallback,MatchValuePtr)	\

	{																						\
		UsbIdsContext.MatchLinePredicate = &PredicateCallback;								\
		UsbIdsContext.MatchValue = MatchValuePtr;											\
		UsbIdsContext.SourceText = StartTextPtr;											\
	}
#endif

#ifndef CopyUsbIdText
#define CopyUsbIdText(UsbIdsContext,Buffer)												\

	{																						\
		strncpy(Buffer, UsbIdsContext.Found.MatchStart, UsbIdsContext.Found.MatchLength);	\
		Buffer[UsbIdsContext.Found.MatchLength]='\0';									\
	}
#endif

typedef struct _FIND_USBIDS_CONTEXT
{

	LPCSTR SourceText;
	LPCSTR (WINAPI* MatchLinePredicate)(LPCSTR, PVOID, PULONG);
	PVOID MatchValue;
	LPCSTR NextLine;
	struct
	{
		ULONG MatchLength;
		LPCSTR MatchStart;

	} Found;
} FIND_USBIDS_CONTEXT, *PFIND_USBIDS_CONTEXT;

BOOL WINAPI EnumLines(PFIND_USBIDS_CONTEXT context);

VOID WINAPI GetHwIdDisplayText(__in USHORT VendorID,
                               __in USHORT ProductID,
                               __out PCHAR VendorName,
                               __out PCHAR ProductName);

VOID WINAPI GetClassDisplayText(__in UCHAR ClassID,
                                __in UCHAR SubClassID,
                                __in UCHAR ProtocolID,
                                __out PCHAR ClassName,
                                __out PCHAR SubClassName,
                                __out PCHAR ProtocolName);

VOID WINAPI GetHidDescriptorItemDisplayText(__in UCHAR ItemType,
        __out PCHAR ItemName);

VOID WINAPI GetHidUsagePageText(__in UCHAR UsagePage,
                                __out PCHAR UsagePageName,
                                __out PFIND_USBIDS_CONTEXT context);

VOID WINAPI GetHidUsageText(__in USHORT Usage,
                            __out PCHAR UsageName,
                            __in PFIND_USBIDS_CONTEXT startContext);

VOID WINAPI GetHidCountryCodeText(__in UCHAR CountryCode,
                                  __out PCHAR CountryName);
#endif