devreq.h File Reference

#include "hubid.h"

Include dependency graph for devreq.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	HUB_MSOS_INDEX_EXT_CONFIG   4
#define	HUB_MSOS_INDEX_EXT_PROPERTIES   5
#define	HUB_MSOS_INDEX_CONTAINER_ID   6
#define	HUB_MSOS20_INDEX_SET   7
#define	HUB_MSOS20_INDEX_ALT_ENUM   8
#define	HUB_MSOS_STRING_INDEX   0xEE

Functions
BOOLEAN NTAPI	HubDeviceSend (_In_ HubChild *Child, _In_reads_bytes_opt_(Length) PVOID Buffer, _In_ ULONG Length, _In_ BOOLEAN ShortTransferOk)
FORCEINLINE ULONG NTAPI	HubDeviceBytesReturned (_In_ HubChild *Child)
VOID NTAPI	HubDeviceDescContext (_In_ HubChild *Child, _Out_ HubDescContext *Context)
VOID NTAPI	HubCompleteFdoDescriptorRequest (_In_ HubChild *Child, _In_ WDFREQUEST Request, _In_ NTSTATUS Status, _In_ ULONG Size)

Macro Definition Documentation

HUB_MSOS20_INDEX_ALT_ENUM

#define HUB_MSOS20_INDEX_ALT_ENUM   8

Definition at line 17 of file devreq.h.

HUB_MSOS20_INDEX_SET

#define HUB_MSOS20_INDEX_SET   7

Definition at line 16 of file devreq.h.

HUB_MSOS_INDEX_CONTAINER_ID

#define HUB_MSOS_INDEX_CONTAINER_ID   6

Definition at line 15 of file devreq.h.

HUB_MSOS_INDEX_EXT_CONFIG

#define HUB_MSOS_INDEX_EXT_CONFIG   4

Definition at line 13 of file devreq.h.

HUB_MSOS_INDEX_EXT_PROPERTIES

#define HUB_MSOS_INDEX_EXT_PROPERTIES   5

Definition at line 14 of file devreq.h.

HUB_MSOS_STRING_INDEX

#define HUB_MSOS_STRING_INDEX   0xEE

Definition at line 20 of file devreq.h.

Function Documentation

HubCompleteFdoDescriptorRequest()

VOID NTAPI HubCompleteFdoDescriptorRequest	(	_In_ HubChild *	Child,
		_In_ WDFREQUEST	Request,
		_In_ NTSTATUS	Status,
		_In_ ULONG	Size
	)

Completes the hub FDO descriptor request and drops the "User Mode FDO Request" device reference.

Definition at line 372 of file hubioctl.cpp.

{
    HubIoCompleteDescriptor(Request, Status, Size);
    WdfObjectDereferenceWithTag(Child->m_Object, (PVOID)HubTagUserRequest);
}

Referenced by DeviceMachine::FailHubDescriptorRequest(), DeviceMachine::GetDescriptorForHub(), and HubFdoDescriptorComplete().

HubDeviceBytesReturned()

FORCEINLINE ULONG NTAPI HubDeviceBytesReturned

(

_In_ HubChild *

Child

)

Bytes the last device transfer returned.

Definition at line 37 of file devreq.h.

{
    return Child->m_Control.Urb.TransferBufferLength;
}

Referenced by DeviceMachine::AltModeStringValid(), DeviceMachine::BillboardStringValid(), DeviceMachine::BosComplete(), DeviceMachine::BosHeaderValid(), DeviceMachine::BosValid(), DeviceMachine::ConfigDescriptorValid(), DeviceMachine::ConfigLongerThanRead(), DeviceMachine::ContainerIdHeaderValid(), DeviceMachine::ContainerIdKnown(), DeviceMachine::DeviceDescriptorValid(), DeviceMachine::ExtendedConfigHeaderValid(), DeviceMachine::ExtendedConfigValid(), DeviceMachine::FirstDescriptorValid(), HubCacheString(), DeviceMachine::MsOs20SetValid(), DeviceMachine::MsOsDescriptorValid(), and DeviceMachine::QualifierValid().

HubDeviceDescContext()

VOID NTAPI HubDeviceDescContext	(	_In_ HubChild *	Child,
		_Out_ HubDescContext *	Context
	)

Validator context for a device, with its validation bits and hacks.

Definition at line 35 of file devdesc.cpp.

{
    HubDescInitDeviceContext(Context,
                             Child->m_DeviceDescriptor.bcdUSB,
                             Child->Speed(),
                             Child->HasHack(ChildHack::UseWin8DescriptorValidation),
                             Child->m_Port->m_Info.SspIsochBurstCount,
                             Child->m_ValidationBits);
 
    /* Only names the device in the validator's debug prints */
    Context->LogContext = Child;
}

Referenced by DeviceMachine::AltModeStringValid(), DeviceMachine::BillboardStringValid(), DeviceMachine::BosHeaderValid(), DeviceMachine::BosValid(), DeviceMachine::ConfigDescriptorValid(), DeviceMachine::ContainerIdHeaderValid(), DeviceMachine::ContainerIdKnown(), DeviceMachine::DeviceDescriptorValid(), DeviceMachine::ExtendedConfigHeaderValid(), DeviceMachine::ExtendedConfigValid(), DeviceMachine::FirstDescriptorValid(), HubCacheString(), DeviceMachine::MsOs20SetValid(), and DeviceMachine::MsOsDescriptorValid().

HubDeviceSend()

BOOLEAN NTAPI HubDeviceSend	(	_In_ HubChild *	Child,
		_In_reads_bytes_opt_(Length) PVOID	Buffer,
		_In_ ULONG	Length,
		_In_ BOOLEAN	ShortTransferOk
	)

Sends the setup packet in Child->m_Control; on FALSE the caller posts TransferFailed.

Definition at line 262 of file devreq.cpp.

{
    NTSTATUS Status;
 
    Status = Child->m_Control.Send(Child->m_Hub->m_RootHubTarget,
                                   Child->m_UsbDevice,
                                   HubDeviceControlComplete,
                                   Child,
                                   Buffer,
                                   Length,
                                   ShortTransferOk,
                                   Child->m_NeedsForwardProgress);
    if (NT_SUCCESS(Status))
        return TRUE;
 
    Child->m_Control.UsbdFlags = 0;
    DPRINT1("Device %p transfer refused 0x%lx\n", Child, Status);
    return FALSE;
}

Referenced by HubDeviceTrySend(), DeviceMachine::ReadAltModeString(), and DeviceMachine::SetInterface().