dxd::usb_device Class Reference

#include <dxd_usb.h>

Inheritance diagram for dxd::usb_device:

Collaboration diagram for dxd::usb_device:

Classes
class	pipe
	IOKit: USB pipe class. More...

Public Types
enum	speed {   low =::kUSBHostConnectionSpeedLow , full =::kUSBHostConnectionSpeedFull , high =::kUSBHostConnectionSpeedHigh , usb1 =full ,   usb2 =high , low =::kUSBHostConnectionSpeedLow , full =::kUSBHostConnectionSpeedFull , high =::kUSBHostConnectionSpeedHigh ,   usb1 =full , usb2 =high }
enum	speed {   low =::kUSBHostConnectionSpeedLow , full =::kUSBHostConnectionSpeedFull , high =::kUSBHostConnectionSpeedHigh , usb1 =full ,   usb2 =high , low =::kUSBHostConnectionSpeedLow , full =::kUSBHostConnectionSpeedFull , high =::kUSBHostConnectionSpeedHigh ,   usb1 =full , usb2 =high }

Public Member Functions
os_result	clear ()
unsigned char	configuration () const
unsigned char	configuration () const
	return available USB configurations
os_result	configuration (unsigned char configuration)
os_result	configuration (unsigned char configuration)
	choose USB configuration
unsigned char	configurations () const
unsigned char	configurations () const
	return current USB configuration
decltype(dx::usb::descriptor::device)	descriptor () const
	IOKit: request the USB device descriptor.
uint64_t	frame () const
uint64_t	frame () const
::IOUSBHostInterface *	interface (unsigned char index, unsigned char setting=0)
	IOKit: USB interface.
const ::USBD_INTERFACE_INFORMATION *	interface (unsigned char index, unsigned char setting=0)
	operator const ::HANDLE () const
	operator::DEVICE_OBJECT * () const
	operator::IOUSBHostDevice * () const
	IOKit: IOUSBDevice* implicit cast.
template<typename type_t>
os_result	query (const ::UNICODE_STRING &key, type_t &value)
template<typename key_t, typename type_t>
os_result	query (key_t *key, type_t &value)
os_result	remove ()
template<typename data_t>
os_result	request (const dx::usb::control &control, data_t &data)
	IOKit: synchronously sends an USB request.
template<typename data_t>
os_result	request (const dx::usb::control &control, data_t &data)
os_result	request (const dx::usb::control &control, void *data, size_t &size)
os_result	request (const dx::usb::control &control, void *data, size_t &size)
os_result	set (const ::UNICODE_STRING &key, const ::GUID &value)
os_result	set (const ::UNICODE_STRING &key, const ::UNICODE_STRING &value)
os_result	set (const ::UNICODE_STRING &key, const char *value)
os_result	set (const ::UNICODE_STRING &key, const wchar_t *value)
os_result	set (const ::UNICODE_STRING &key, unsigned int value)
template<typename key_t, typename type_t>
os_result	set (key_t *key, const type_t &value)
speed	speed () const
speed	speed () const
os_result	state () const
os_result	string (unsigned char idx, char *string, unsigned char &chars)
os_result	string (unsigned char idx, char *string, unsigned char &chars, dx::usb::language language=dx::usb::language::standard)
	IOKit: request the USB string descriptor for the index.
template<typename string_t>
os_result	string (unsigned char idx, string_t &string)
template<typename string_t>
os_result	string (unsigned char idx, string_t &string)
template<typename type_t>
unsigned long	type ()
	usb_device (::WDFDEVICE_INIT *wdf_device_init, const ::GUID &guid)
	WDK: USB device constructor.
	~usb_device ()

Public Attributes
os_result	status = not_initialized

Protected Member Functions
void	close_interfaces ()
void	conclude () override
	IOKit: USB conclude.
void	conclude () override
	WDK: USB device de-initialization callback.
os_result	launch () override
	IOKit: USB launch.
os_result	launch () override
	WDK: USB device initialization callback.
os_result	open_interfaces ()
bool	start (::IOService *provider) override
	IOKit: USB start.

Member Enumeration Documentation

speed [1/2]

enum dxd::usb_device::speed

Todo

enum class

Enumerator
low
full
high
usb1
usb2
low
full
high
usb1
usb2

speed [2/2]

enum dxd::usb_device::speed

Enumerator
low
full
high
usb1
usb2
low
full
high
usb1
usb2

Constructor & Destructor Documentation

usb_device()

dxd::usb_device::usb_device ( ::WDFDEVICE_INIT * wdf_device_init, const ::GUID & guid )

inline

WDK: USB device constructor.

Registers PNP capabilities

~usb_device()

dxd::usb_device::~usb_device ( )

inline

Member Function Documentation

clear()

os_result dxd::usb_device::clear ( )

inline

Here is the call graph for this function:

Here is the caller graph for this function:

close_interfaces()

void dxd::usb_device::close_interfaces ( )

inlineprotected

Here is the caller graph for this function:

conclude() [1/2]

void dxd::usb_device::conclude ( )

inlineoverrideprotected

IOKit: USB conclude.

This method:

• iterates over and closes all USB interfaces
• deselects USB configuration
• closes the USB device from exclusive access

• De-selects previosly selected USB configuration,

Todo

investigate if reset() is still needed here

• closes the USB device, so another driver has the chance to match against (important: this driver will not unload otherwise)
  

Here is the call graph for this function:

conclude() [2/2]

void dxd::usb_device::conclude ( )

inlineoverrideprotected

WDK: USB device de-initialization callback.

Here is the call graph for this function:

configuration() [1/4]

unsigned char dxd::usb_device::configuration ( ) const

inline

Here is the call graph for this function:

Here is the caller graph for this function:

configuration() [2/4]

unsigned char dxd::usb_device::configuration ( ) const

inline

return available USB configurations

configuration() [3/4]

os_result dxd::usb_device::configuration ( unsigned char configuration )

inline

Here is the call graph for this function:

configuration() [4/4]

os_result dxd::usb_device::configuration ( unsigned char configuration )

inline

choose USB configuration

removes interface cache

deselects current configuration on request #0

obtains the configuration descriptor,

obtains all descriptors,

enumerates interfaces in the configuration,

allocates and builds an URB for the select-configuration request,

creates interface cache

enumerates the pipes in the interface information array, which is now filled with pipe information.

Here is the call graph for this function:

configurations() [1/2]

unsigned char dxd::usb_device::configurations ( ) const

inline

Here is the call graph for this function:

configurations() [2/2]

unsigned char dxd::usb_device::configurations ( ) const

inline

return current USB configuration

descriptor()

decltype(dx::usb::descriptor::device) dxd::usb_device::descriptor ( ) const

inline

IOKit: request the USB device descriptor.

Deprecated

Here is the call graph for this function:

frame() [1/2]

uint64_t dxd::usb_device::frame ( ) const

inline

Here is the call graph for this function:

Here is the caller graph for this function:

frame() [2/2]

uint64_t dxd::usb_device::frame ( ) const

inline

Here is the call graph for this function:

interface() [1/2]

::IOUSBHostInterface * dxd::usb_device::interface ( unsigned char index, unsigned char setting = 0 )

inline

IOKit: USB interface.

Selects the USB interface

checks interface, if it fails: was it configured?

and selects the (alternate) setting

Parameters

index	index of the USB interface in the USB configuration
setting	setting # of the USB interface

Here is the caller graph for this function:

interface() [2/2]

const ::USBD_INTERFACE_INFORMATION * dxd::usb_device::interface ( unsigned char index, unsigned char setting = 0 )

inline

requests settings change,

disposes and creates new interface cache on size change,

and fills interface cache,

launch() [1/2]

os_result dxd::usb_device::launch ( )

inlineoverrideprotected

IOKit: USB launch.

This method:

• opens the USB device for exclusive access,
• selects default USB configuration
• iterates over and opens all USB interfaces

Here is the call graph for this function:

launch() [2/2]

os_result dxd::usb_device::launch ( )

inlineoverrideprotected

WDK: USB device initialization callback.

obtain vage speed info

obtains the device descriptor,

and select USB configuration #1.

Here is the call graph for this function:

open_interfaces()

os_result dxd::usb_device::open_interfaces ( )

inlineprotected

Here is the caller graph for this function:

operator const ::HANDLE()

dxd::wdm::registry::operator const ::HANDLE ( ) const

inlineinherited

Here is the caller graph for this function:

operator::DEVICE_OBJECT *()

dxd::usb_device::operator::DEVICE_OBJECT * ( ) const

inline

operator::IOUSBHostDevice *()

dxd::usb_device::operator::IOUSBHostDevice * ( ) const

inline

IOKit: IOUSBDevice* implicit cast.

query() [1/2]

template<typename type_t>

os_result dxd::wdm::registry::query ( const ::UNICODE_STRING & key, type_t & value )

inlineinherited

query() [2/2]

template<typename key_t, typename type_t>

os_result dxd::wdm::registry::query ( key_t * key, type_t & value )

inlineinherited

Here is the call graph for this function:

Here is the caller graph for this function:

remove()

os_result dxd::wdm::registry::remove ( )

inlineinherited

request() [1/4]

template<typename data_t>

os_result dxd::usb_device::request ( const dx::usb::control & control, data_t & data )

inline

IOKit: synchronously sends an USB request.

Todo

USB device control request timeout

Parameters

control	the USB request control defining the request type
data	data to transmit or receive

Here is the call graph for this function:

Here is the caller graph for this function:

request() [2/4]

template<typename data_t>

os_result dxd::usb_device::request ( const dx::usb::control & control, data_t & data )

inline

Parameters

control	the USB request control defining the request type
data	data to transmit or receive

Here is the call graph for this function:

request() [3/4]

os_result dxd::usb_device::request ( const dx::usb::control & control, void * data, size_t & size )

inline

Parameters

control	the USB request control defining the request type
data	data to transmit or receive
size	size of the actual transaction

Here is the call graph for this function:

request() [4/4]

os_result dxd::usb_device::request ( const dx::usb::control & control, void * data, size_t & size )

inline

set() [1/6]

os_result dxd::wdm::registry::set ( const ::UNICODE_STRING & key, const ::GUID & value )

inlineinherited

Here is the call graph for this function:

Here is the caller graph for this function:

set() [2/6]

os_result dxd::wdm::registry::set ( const ::UNICODE_STRING & key, const ::UNICODE_STRING & value )

inlineinherited

set() [3/6]

os_result dxd::wdm::registry::set ( const ::UNICODE_STRING & key, const char * value )

inlineinherited

Here is the call graph for this function:

Here is the caller graph for this function:

set() [4/6]

os_result dxd::wdm::registry::set ( const ::UNICODE_STRING & key, const wchar_t * value )

inlineinherited

Here is the call graph for this function:

Here is the caller graph for this function:

set() [5/6]

os_result dxd::wdm::registry::set ( const ::UNICODE_STRING & key, unsigned int value )

inlineinherited

set() [6/6]

template<typename key_t, typename type_t>

os_result dxd::wdm::registry::set ( key_t * key, const type_t & value )

inlineinherited

Here is the call graph for this function:

Here is the caller graph for this function:

speed() [1/2]

speed dxd::usb_device::speed ( ) const

inline

speed() [2/2]

speed dxd::usb_device::speed ( ) const

inline

Todo

implement WDK low/super speed check for dxd::usb_device.speed()

start()

bool dxd::usb_device::start ( ::IOService * provider )

inlineoverrideprotected

IOKit: USB start.

Here is the caller graph for this function:

state()

os_result dxd::usb_device::state ( ) const

inline

Todo

find out if isInactive() is equivalent to getState()

Here is the caller graph for this function:

string() [1/4]

os_result dxd::usb_device::string ( unsigned char idx, char * string, unsigned char & chars )

inline

string() [2/4]

os_result dxd::usb_device::string ( unsigned char idx, char * string, unsigned char & chars, dx::usb::language language = dx::usb::language::standard )

inline

IOKit: request the USB string descriptor for the index.

Parameters

idx	index of the string to request
string	preallocated string buffer
chars	number of characters returned

Here is the call graph for this function:

Here is the caller graph for this function:

string() [3/4]

template<typename string_t>

os_result dxd::usb_device::string ( unsigned char idx, string_t & string )

inline

Here is the call graph for this function:

string() [4/4]

template<typename string_t>

os_result dxd::usb_device::string ( unsigned char idx, string_t & string )

inline

Here is the call graph for this function:

type()

template<typename type_t>

unsigned long dxd::wdm::registry::type ( )

inherited

Here is the caller graph for this function:

Member Data Documentation

status

os_result dxd::wdm::registry::status = not_initialized

inherited

---

The documentation for this class was generated from the following files:

• iokit/dxd_usb.h
• wdk/dxd_usb.h