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

/*! \file drv_queue.h
*/

#ifndef __DRV_QUEUE_H__
#define __DRV_QUEUE_H__


#include "drv_private.h"

// Used to detect when a high speed isochronous transfer function is needed.
#define IsHighSpeedDevice(DeviceContextPtr) (DeviceContextPtr->DeviceSpeed >= UsbHighSpeed ? TRUE : FALSE)


#define FUNCTION_FROM_CTL_CODE(ctrlCode) (((ULONG)(ctrlCode & 0x3FFC)) >> 2)


//////////////////////////////////////////////////////////////////////////////
// lusbk_queue.c function prototypes.
// Default queue events.
//
EVT_WDF_IO_QUEUE_IO_READ DefaultQueue_OnRead;
EVT_WDF_IO_QUEUE_IO_WRITE DefaultQueue_OnWrite;
EVT_WDF_IO_QUEUE_IO_DEVICE_CONTROL DefaultQueue_OnIoControl;

EVT_WDF_IO_QUEUE_IO_STOP Queue_OnStop;
EVT_WDF_IO_QUEUE_IO_RESUME  Queue_OnResume;

EVT_WDF_IO_QUEUE_IO_READ PipeQueue_OnRead;
EVT_WDF_IO_QUEUE_IO_WRITE PipeQueue_OnWrite;
EVT_WDF_IO_QUEUE_IO_DEVICE_CONTROL PipeQueue_OnIoControl;

FORCEINLINE VOID ForwardToQueue(__in WDFREQUEST Request,
                                __in PREQUEST_CONTEXT requestContext)

{
	NTSTATUS                status = STATUS_SUCCESS;

	// forward the requests to their own queues.
	//
	status = WdfRequestForwardToIoQueue(Request, WdfObjectContextGetObject(requestContext->QueueContext));
	if(!NT_SUCCESS(status))
	{
		USBERR("WdfRequestForwardToIoQueue failed. status=%Xh\n", status);
		goto Exit;
	}
	else
	{
		return;
	}

Exit:
	WdfRequestCompleteWithInformation(Request, status, 0);
	return;
}

FORCEINLINE VOID ForwardToPipeQueue(__in WDFREQUEST Request,
                                    __in PDEVICE_CONTEXT deviceContext,
                                    __in PREQUEST_CONTEXT requestContext,
                                    __in UCHAR PipeID,
                                    __in WDF_REQUEST_TYPE requestType)
{

	NTSTATUS status;
	WDFQUEUE pipeQueue;

	if ((pipeQueue = GetPipeContextByID(deviceContext, PipeID)->Queue) == NULL)
	{
		status = STATUS_INVALID_DEVICE_STATE;
		USBERR("Invalid pipe queue.\n");
		goto Exit;
	}

	requestContext->QueueContext = GetQueueContext(pipeQueue);
	requestContext->RequestType = requestType;

	status = WdfRequestForwardToIoQueue(Request, pipeQueue);
	if(!NT_SUCCESS(status))
	{
		USBERR("WdfRequestForwardToIoQueue failed. status=%Xh\n", status);
		goto Exit;
	}

	return;
Exit:
	WdfRequestCompleteWithInformation(Request, status, 0);
	return;

}

#endif