usbutil.hpp

Go to the documentation of this file.

//
//    Copyright (C) Microsoft.  All rights reserved.
//
#ifndef __FX_USB_UTIL_H__
#define __FX_USB_UTIL_H__

BOOLEAN
__inline
FxBitArraySet(
    __inout_xcount((BitNumber / sizeof(UCHAR)) + 1) PUCHAR BitArray,
    __in UCHAR  BitNumber
    )
/*++

Routine Description:
    The following function sets a bit in the array and returns a value indicating
    the bits previous state.

Arguments:
    BitArray - the array to check

    BitNumber - zero based index into BitArray

Return Value:
    TRUE if the bit was already set
    FALSE if was previously clear

  --*/
{
    UCHAR index;
    UCHAR bit;

    index = (BitNumber) / sizeof(UCHAR);
    bit = (UCHAR) (1 << (BitNumber % sizeof(UCHAR)) );

    if ((BitArray[index] & bit) == 0x0) {
        //
        // bit not set
        //
        BitArray[index] |= bit;
        return FALSE;
    }

    return TRUE;
}

VOID
__inline
FxBitArrayClear(
    __inout_xcount((BitNumber / sizeof(UCHAR)) + 1) PUCHAR BitArray,
    __in UCHAR  BitNumber
    )
/*++

Routine Description:
    Clear the bit in the BitArray

Arguments:
    BitArray - bit array to change

    BitNumber - zero based bit index into the array to clear

  --*/
{
    UCHAR index;
    UCHAR bit;

    index =  BitNumber / sizeof(UCHAR);
    bit = (UCHAR) (1 << (BitNumber % sizeof(UCHAR)) );

    BitArray[index] &= ~bit;
}

VOID
FxFormatUsbRequest(
    __in FxRequestBase* Request,
    __in PURB Urb,
    __in FX_URB_TYPE FxUrbType,
    __drv_when(FxUrbType == FxUrbTypeUsbdAllocated, __in)
    __drv_when(FxUrbType != FxUrbTypeUsbdAllocated, __in_opt)
         USBD_HANDLE UsbdHandle
    );

NTSTATUS
FxFormatUrbRequest(
    __in PFX_DRIVER_GLOBALS FxDriverGlobals,
    __in FxIoTarget* Target,
    __in FxRequestBase* Request,
    __in FxRequestBuffer* Buffer,
    __in FX_URB_TYPE FxUrbType,
    __drv_when(FxUrbType == FxUrbTypeUsbdAllocated, __in)
    __drv_when(FxUrbType != FxUrbTypeUsbdAllocated, __in_opt)
         USBD_HANDLE UsbdHandle
    );

PUSB_INTERFACE_DESCRIPTOR
FxUsbParseConfigurationDescriptor(
    __in PUSB_CONFIGURATION_DESCRIPTOR ConfigDesc,
    __in UCHAR InterfaceNumber = -1,
    __in UCHAR AlternateSetting = 1
    );

PURB
FxUsbCreateConfigRequest(
    __in PFX_DRIVER_GLOBALS FxDriverGlobals,
    __in PUSB_CONFIGURATION_DESCRIPTOR ConfigDesc,
    __in PUSBD_INTERFACE_LIST_ENTRY InterfaceList,
    __in ULONG DefaultMaxPacketSize
    );

NTSTATUS
FxUsbValidateConfigDescriptorHeaders(
    __in PFX_DRIVER_GLOBALS FxDriverGlobals,
    __in PUSB_CONFIGURATION_DESCRIPTOR ConfigDescriptor,
    __in size_t ConfigDescriptorLength
    );

PUSB_COMMON_DESCRIPTOR
FxUsbFindDescriptorType(
    __in PVOID Buffer,
    __in size_t BufferLength,
    __in PVOID Start,
    __in LONG DescriptorType
    );

enum FxUsbValidateDescriptorOp {
    FxUsbValidateDescriptorOpEqual,
    FxUsbValidateDescriptorOpAtLeast
};

NTSTATUS
FxUsbValidateDescriptorType(
    __in PFX_DRIVER_GLOBALS FxDriverGlobals,
    __in PUSB_CONFIGURATION_DESCRIPTOR ConfigDescriptor,
    __in PVOID Start,
    __in PVOID End,
    __in LONG DescriptorType,
    __in size_t SizeToValidate,
    __in FxUsbValidateDescriptorOp Op,
    __in ULONG MaximumNumDescriptorsToValidate
    );

#if (FX_CORE_MODE == FX_CORE_USER_MODE)
VOID
FxUsbUmFormatRequest(
    __in FxRequestBase* Request,
    __in_xcount(Urb->Length) PUMURB_HEADER Urb,
    __in IWudfFile* HostFile,
    __in BOOLEAN Reuse = FALSE
    );

VOID
FxUsbUmInitDescriptorUrb(
    __inout PUMURB UmUrb,
    __in WINUSB_INTERFACE_HANDLE WinUsbHandle,
    __in UCHAR DescriptorType,
    __in ULONG BufferLength,
    __in PVOID Buffer
    );

VOID
FxUsbUmInitControlTransferUrb(
    __inout PUMURB UmUrb,
    __in WINUSB_INTERFACE_HANDLE WinUsbHandle,
    __in ULONG BufferLength,
    __in PVOID Buffer
    );

VOID
FxUsbUmInitInformationUrb(
    __inout PUMURB UmUrb,
    __in WINUSB_INTERFACE_HANDLE WinUsbHandle,
    __in ULONG BufferLength,
    __in PVOID Buffer
    );
#endif // (FX_CORE_MODE == FX_CORE_USER_MODE)

#endif // __FX_USB_UTIL_H__