childpdo.cpp File Reference

#include "usbhub3.h"
#include "devhcd.h"
#include <debug.h>

Include dependency graph for childpdo.cpp:

Go to the source code of this file.

Classes
struct	HubStartFailHeader
struct	HubBillboardHeader
struct	HubBillboardMode
struct	HubPdoIrpWork

Macros
#define	NDEBUG
#define	HUB_PDO_DRIVER_WAIT_TIME   10000
#define	HUB_URB_FUNCTION_LAST   0x003C
#define	HUB_URB_FUNCTION_FAST_PATH_1   0x0039
#define	HUB_URB_FUNCTION_FAST_PATH_2   0x003A
#define	HUB_URB_FUNCTION_SELECT_LIKE   0x003B
#define	HUB_MSOS20_SET_INDEX   7
#define	HUB_USB_BUFFERED_IOCTL(Function)    CTL_CODE(FILE_DEVICE_USB, Function, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define	HUB_IOCTL_GET_TRANSPORT_CHARACTERISTICS   HUB_USB_BUFFERED_IOCTL(USB_GET_TRANSPORT_CHARACTERISTICS)
#define	HUB_IOCTL_REGISTER_TRANSPORT_CHANGE   HUB_USB_BUFFERED_IOCTL(USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE)
#define	HUB_IOCTL_NOTIFY_TRANSPORT_CHANGE   HUB_USB_BUFFERED_IOCTL(USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE)
#define	HUB_IOCTL_UNREGISTER_TRANSPORT_CHANGE   HUB_USB_BUFFERED_IOCTL(USB_UNREGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE)
#define	HUB_IOCTL_START_TIME_SYNC   HUB_USB_BUFFERED_IOCTL(USB_START_TRACKING_FOR_TIME_SYNC)
#define	HUB_IOCTL_GET_TIME_SYNC   HUB_USB_BUFFERED_IOCTL(USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC)
#define	HUB_IOCTL_STOP_TIME_SYNC   HUB_USB_BUFFERED_IOCTL(USB_STOP_TRACKING_FOR_TIME_SYNC)
#define	HUB_IOCTL_GET_DEVICE_CHARACTERISTICS   HUB_USB_BUFFERED_IOCTL(USB_GET_DEVICE_CHARACTERISTICS)
#define	HUB_TRANSPORT_REGISTRATION_SIZE   (sizeof(ULONG) + sizeof(PVOID) + 24)
#define	HUB_DEVICE_CHARACTERISTICS_SIZE   0x18
#define	HUB_STAMPED_HANDLE_OFFSET   4
#define	HUB_IOCTL_MEDIA_SERIAL_NUMBER   CTL_CODE(FILE_DEVICE_MASS_STORAGE, 0x0304, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define	HUB_START_FAIL_MAX   4096
#define	HUB_LPM_POLICY_LINK_BITS

Typedefs
typedef VOID(NTAPI *	PFN_HUB_SET_SYSTEM_WAKE_DEVICE) (_In_ PDEVICE_OBJECT DeviceObject)

Enumerations
enum	HubLpmSlot {   HubLpmU1Enable , HubLpmU2Enable , HubLpmU1Timeout , HubLpmU2Timeout ,   HubLpmPolicy }

Functions
	C_ASSERT (sizeof(HubBillboardHeader)==4)
	C_ASSERT (sizeof(HubBillboardMode)==8)
	WDF_DECLARE_CONTEXT_TYPE_WITH_NAME (HubPdoIrpWork, HubGetPdoIrpWork)
USBD_STATUS NTAPI	HubNtStatusToUsbd (_In_ NTSTATUS Status)
static NTSTATUS NTAPI	HubUsbdStatusToNt (_In_ USBD_STATUS Status)
	_IRQL_requires_ (PASSIVE_LEVEL) NTSTATUS NTAPI HubPdoPostAndWait(_In_ HubChild *Child
	Sends a synchronous IOCTL to the specified device object.
Child	Post (Event)
static NTSTATUS NTAPI	HubPdoCompleteIrp (_Inout_ PIRP Irp, _In_ NTSTATUS Status)
static NTSTATUS NTAPI	HubPdoCompleteAsIs (_Inout_ PIRP Irp)
static NTSTATUS NTAPI	HubPdoPassDown (_In_ WDFDEVICE Device, _Inout_ PIRP Irp)
static NTSTATUS NTAPI	HubPdoToController (_In_ HubPdo *Pdo, _Inout_ PIRP Irp)
static NTSTATUS NTAPI	HubPdoSignalCompletion (_In_ PDEVICE_OBJECT DeviceObject, _In_ PIRP Irp, _In_reads_opt_(_Inexpressible_("varies")) PVOID Context)
	IoCopyCurrentIrpStackLocationToNext (Irp)
	IoSetCompletionRoutine (Irp, HubPdoSignalCompletion, &Event, TRUE, TRUE, TRUE)
	WdfDeviceWdmDispatchPreprocessedIrp (Device, Irp)
static VOID NTAPI	HubD3ColdReference (_In_ PVOID Context)
static VOID NTAPI	HubD3ColdDereference (_In_ PVOID Context)
	if (Pdo->m_AcpiD3Cold.SetD3ColdSupport !=NULL) Pdo -> m_AcpiD3Cold.SetD3ColdSupport(Pdo->m_AcpiD3Cold.Context, D3ColdSupport)
	if (D3ColdSupport) Pdo -> m_Child->SetState(ChildState::D3ColdEnabledByDriver)
else Pdo m_Child	ClearState (ChildState::D3ColdEnabledByDriver)
	PAGED_CODE ()
	if (Pdo->m_AcpiD3Cold.GetIdleWakeInfo !=NULL)
	if (Pdo->m_Hub->m_Capabilities.SystemWake >=SystemPowerState &&(Child->HasProperty(ChildProperty::RemoteWakeCapable)||Child->HasProperty(ChildProperty::IsHub)))
	if (Pdo->m_AcpiD3Cold.GetD3ColdCapability==NULL)
	if (NT_SUCCESS(Status) &&*D3ColdSupported &&Pdo->m_Child->m_Port->HasProperty(PortProperty::Removable))
	_IRQL_requires_max_ (DISPATCH_LEVEL) static VOID NTAPI HubD3ColdGetLastTransition(_In_reads_opt_(_Inexpressible_("varies")) PVOID Context
	if (Pdo->m_AcpiD3Cold.GetLastTransitionStatus !=NULL)
	if (Pdo->HasFlag(PdoFlag::WasResetAtResume)) *LastTransitionStatus
static NTSTATUS NTAPI	HubPdoAnswerD3Cold (_In_ HubPdo *Pdo, _Inout_ PIRP Irp)
static NTSTATUS NTAPI	HubPdoQueryInterface (_In_ HubPdo *Pdo, _Inout_ PIRP Irp)
	RtlInitEmptyUnicodeString (SymbolicLinkName, NULL, 0)
	if (Pdo->m_SymbolicLink !=NULL) WdfStringGetUnicodeString(Pdo -> m_SymbolicLink, SymbolicLinkName)
static BOOLEAN NTAPI	HubPdoIsEnhancedSuperSpeed (_In_ HubChild *Child)
static NTSTATUS NTAPI	HubPdoEvtParentInterfaceQuery (_In_ WDFDEVICE Device, _In_ LPGUID InterfaceType, _Inout_ PINTERFACE ExposedInterface, _Inout_opt_ PVOID ExposedInterfaceSpecificData)
	_IRQL_requires_max_ (PASSIVE_LEVEL) static NTSTATUS NTAPI HubPdoGetLocationString(_Inout_opt_ PVOID Context
	if (Buffer==NULL)
	if (!NT_SUCCESS(Status)) DPRINT1("Location string failed 0x%lx\n"
	if (Pdo->HasFlag(PdoFlag::Started)||Stack->Parameters.QueryId.IdType !=BusQueryDeviceID||KeGetCurrentIrql() !=PASSIVE_LEVEL)
	HubPdoPreStart (Pdo->m_Child)
	WdfDeviceResumeIdle (HubDevice)
static NTSTATUS NTAPI	HubPdoPreprocessPnp (_In_ WDFDEVICE Device, _Inout_ PIRP Irp)
static VOID NTAPI	HubPdoEvtCompletePowerIrp (_In_ WDFWORKITEM WorkItem)
static NTSTATUS NTAPI	HubPdoPowerIrpComplete (_In_ PDEVICE_OBJECT DeviceObject, _In_ PIRP Irp, _In_reads_opt_(_Inexpressible_("varies")) PVOID Context)
static NTSTATUS NTAPI	HubPdoPreprocessSetPower (_In_ WDFDEVICE Device, _Inout_ PIRP Irp)
	UNREFERENCED_PARAMETER (ResourcesRaw)
	UNREFERENCED_PARAMETER (ResourcesTranslated)
	DPRINT ("Child PDO %p on port %u prepare hardware\n", Device, Pdo->m_PortNumber)
Pdo	SetFlag (PdoFlag::Started)
	HubReadDeviceHardwareValues (Child)
	if (HubUsb4NeedsHostPower(Child))
	HubCacheMsOs20SetInfo (Child)
	HubFlushSqmFlags (Child)
	HubWriteEnumerationData (Child)
	if (Child->HasProperty(ChildProperty::IsHub))
	if (Pdo->m_SymbolicLink==NULL)
	if (!Pdo->HasFlag(PdoFlag::DeviceGone) &&Child->HasState(ChildState::WorkingDevice)) Pdo -> m_FailRequests=FALSE
	if (!Child->HasProperty(ChildProperty::IsHub) &&!Child->HasProperty(ChildProperty::IsComposite)) HubWmiRegisterDevice(Device)
	DPRINT ("Child PDO %p on port %u release hardware\n", Device, Pdo->m_PortNumber)
Pdo	ClearFlag (PdoFlag::Started)
	if (Pdo->TestAndClearFlag(PdoFlag::QueryStopped)) return STATUS_SUCCESS
	if (Pdo->TestAndClearFlag(PdoFlag::QueryRemoved)) HubPurgeUxdState(Child
	if (Child->HasProperty(ChildProperty::DualRole)) Child -> ClearProperty(ChildProperty::DualRole)
static NTSTATUS NTAPI	HubPdoEvtQueryStop (_In_ WDFDEVICE Device)
static NTSTATUS NTAPI	HubPdoEvtQueryRemove (_In_ WDFDEVICE Device)
static VOID NTAPI	HubPdoEvtReportedMissing (_In_ WDFDEVICE Device)
	UNREFERENCED_PARAMETER (IoResourceRequirementsList)
	if (!Pdo->HasFlag(PdoFlag::Started)) HubPdoPreStart(Pdo -> m_Child)
	HubPdoPostAndWait (Pdo->m_Child, DsmEvent::PdoInstallMsOsExt, "PdoInstallMsOsExt")
static NTSTATUS NTAPI	HubPdoEvtSelfManagedIoStart (_In_ WDFDEVICE Device)
static NTSTATUS NTAPI	HubPdoEvtSelfManagedIoSuspend (_In_ WDFDEVICE Device)
	UNREFERENCED_PARAMETER (PreviousState)
	DPRINT ("Child PDO %p on port %u D0 entry from %d\n", Device, Pdo->m_PortNumber,(int) PreviousState)
Pdo m_Idle	Post (IdleEvent::PoweredUp, NULL)
	if (HubUsb4NeedsHostPower(Pdo->m_Child)) DPRINT("Port %u USB4 power component activation is not available\n"
	DPRINT ("Child PDO %p on port %u D0 exit to %d, action %d\n", Device, Pdo->m_PortNumber,(int) TargetState,(int) Action)
	if (TargetState !=WdfPowerDeviceD3Final &&Action==PowerActionNone) HubRecordSelectiveSuspend(Child)
	if (TargetState==WdfPowerDeviceD3Final &&Action==PowerActionNone)
	if (WdfTimerStop(Child->m_BandwidthRetryTimer, TRUE))
static VOID NTAPI	HubPdoIndicateWake (_In_ HubPdo *Pdo)
static VOID NTAPI	HubPdoWakeNotificationComplete (_In_ WDFREQUEST Request, _In_ WDFIOTARGET Target, _In_ PWDF_REQUEST_COMPLETION_PARAMS Params, _In_ WDFCONTEXT Context)
static NTSTATUS NTAPI	HubPdoSendWakeNotification (_In_ HubPdo *Pdo)
static NTSTATUS NTAPI	HubPdoEvtEnableWakeAtBus (_In_ WDFDEVICE Device, _In_ SYSTEM_POWER_STATE PowerState)
static NTSTATUS NTAPI	HubPdoLpmSettingChanged (_In_ LPCGUID SettingGuid, _In_reads_bytes_(ValueLength) PVOID Value, _In_ ULONG ValueLength, _Inout_opt_ PVOID Context)
static NTSTATUS NTAPI	HubPdoSyncComplete (_In_ PDEVICE_OBJECT DeviceObject, _In_ PIRP Irp, _In_reads_opt_(_Inexpressible_("varies")) PVOID Context)
static NTSTATUS NTAPI	HubPdoQueueAndWait (_In_ HubPdo *Pdo, _Inout_ PIRP Irp, _In_ WDFQUEUE Queue)
static NTSTATUS NTAPI	HubPdoQueueAsync (_In_ HubPdo *Pdo, _Inout_ PIRP Irp)
static VOID NTAPI	HubPdoStampUrb (_In_ HubPdo *Pdo, _Inout_ PURB Urb)
static NTSTATUS NTAPI	HubPdoValidateUrb (_Inout_ PURB Urb)
static PVOID NTAPI	HubPdoUrbBuffer (_In_ PVOID Pointer, _In_opt_ PMDL Mdl)
static NTSTATUS NTAPI	HubPdoCachedDescriptor (_In_ HubPdo *Pdo, _Inout_ PIRP Irp, _Inout_ PURB Urb)
static NTSTATUS NTAPI	HubPdoMsFeatureDescriptor (_In_ HubPdo *Pdo, _Inout_ PIRP Irp, _Inout_ PURB Urb)
static NTSTATUS NTAPI	HubPdoSelectLikeComplete (_In_ PDEVICE_OBJECT DeviceObject, _In_ PIRP Irp, _In_reads_opt_(_Inexpressible_("varies")) PVOID Context)
static NTSTATUS NTAPI	HubPdoForwardSelectLike (_In_ HubPdo *Pdo, _Inout_ PIRP Irp, _Inout_ PURB Urb)
static NTSTATUS NTAPI	HubPdoRouteUrb (_In_ HubPdo *Pdo, _Inout_ PIRP Irp, _Inout_ PURB Urb)
static NTSTATUS NTAPI	HubPdoGetHubName (_In_ HubPdo *Pdo, _Inout_ PIRP Irp)
static NTSTATUS NTAPI	HubPdoRecordFailure (_In_ HubPdo *Pdo, _In_opt_ HubStartFailHeader *Data)
	if (Info==NULL||Info->Version !=1)
	if (Info->Length !=sizeof(*Info))
	RtlZeroMemory (Info, sizeof(*Info))
	if ((Hub->m_ParentInfo.Flags &HUB_PARENT_HIGH_SPEED_CAPABLE)||Hub->m_ParentInfo.DeviceDescriptor.bcdUSB >=0x0200)
	if (Hub->HasFlag(HubFlag::MultiTtHub))
	if (Hub->m_Parent.HubSpeed==UsbHighSpeed) Info -> HubFlags.HubIsHighSpeed=1
	if (Hub->HasFlag(HubFlag::WakeOnConnect)) Info -> HubFlags.HubIsArmedWakeOnConnect=1
	if (Hub->IsRootHub()) Info -> HubFlags.HubIsRoot=1
	if (Hub->m_MaxPortPower==100) Info -> HubFlags.HubIsBusPowered=1
	if (Child->HasProperty(ChildProperty::UxdReserved))
	if (NT_SUCCESS(Status)) Status
static NTSTATUS NTAPI	HubPdoTopologyAddress (_In_ HubPdo *Pdo, _Out_opt_ PUSB_TOPOLOGY_ADDRESS Address)
static VOID NTAPI	HubPdoFillHubInfo (_In_ HubPdo *Pdo, _Inout_ HubParentInfo *Info)
static NTSTATUS NTAPI	HubPdoQueryCapability (_In_ HubPdo *Pdo, _Inout_ PIRP Irp, _Inout_ PUCXHUB_QUERY_CAPABILITY Query)
static NTSTATUS NTAPI	HubPdoCyclePort (_In_ HubPdo *Pdo, _Inout_ PIRP Irp)
static NTSTATUS NTAPI	HubPdoDispatchIoctl (_In_ HubPdo *Pdo, _Inout_ PIRP Irp)
static NTSTATUS NTAPI	HubPdoPreprocessInternalIoctl (_In_ WDFDEVICE Device, _Inout_ PIRP Irp)
static NTSTATUS NTAPI	HubPdoStampAndForward (_In_ HubPdo *Pdo, _Inout_ PIRP Irp, _In_ ULONG Size)
static NTSTATUS NTAPI	HubPdoPreprocessIoctl (_In_ WDFDEVICE Device, _Inout_ PIRP Irp)
static VOID NTAPI	HubPdoEvtIoInternalDeviceControl (_In_ WDFQUEUE Queue, _In_ WDFREQUEST Request, _In_ size_t OutputBufferLength, _In_ size_t InputBufferLength, _In_ ULONG IoControlCode)
static VOID NTAPI	HubPdoEvtIoDeviceControl (_In_ WDFQUEUE Queue, _In_ WDFREQUEST Request, _In_ size_t OutputBufferLength, _In_ size_t InputBufferLength, _In_ ULONG IoControlCode)
VOID NTAPI	HubEvtBandwidthRetryTimer (_In_ WDFTIMER Timer)
VOID NTAPI	HubNoPingResponse (_In_ UCXHUB_HUB_CONTEXT HubContext, _In_ UCXHUB_DEVICE_CONTEXT DeviceContext)
	for (Index=0;;Index++)
	HubPdoResolveSystemWake ()
	if (Known)
	DPRINT1 ("Port %u device failed enumeration, creating a placeholder PDO\n", Port->Number())
	if (!(Hub->HasFlag(HubFlag::InAcpiNamespace) &&Child->HasProperty(ChildProperty::NotRemovable))) HubWmiNotifyEnumerationFailure(Hub
Port	Number ())
	if (Init==NULL)
	HubPdoSetCallbacks (Init)
	WdfDeviceInitSetDeviceType (Init, FILE_DEVICE_UNKNOWN)
	WdfDeviceInitSetExclusive (Init, FALSE)
	WdfPdoInitAllowForwardingRequestToParent (Init)
	WdfDeviceInitSetRemoveLockOptions (Init, &RemoveLock)
	if (!Known)
	WdfObjectReferenceWithTag (Child->m_Object,(PVOID) HubTagPdo)
	WdfDeviceSetSpecialFileSupport (Device, WdfSpecialFilePaging, TRUE)
	WdfDeviceSetSpecialFileSupport (Device, WdfSpecialFileHibernation, TRUE)
	WdfDeviceSetSpecialFileSupport (Device, WdfSpecialFileDump, TRUE)
	WdfDeviceSetSpecialFileSupport (Device, WdfSpecialFileBoot, TRUE)
	HubPdoSetPnpCapabilities (Pdo)
Pdo m_Idle	Initialize (Pdo)
Pdo m_Idle	Post (IdleEvent::Start, NULL)
Pdo	SetFlag (PdoFlag::IdleMachineStarted)
	HubPdoRegisterLpmSettings (Pdo)
	DPRINT1 ("Child PDO %p for port %u, VID %04x PID %04x\n", Device, Pdo->m_PortNumber, Child->m_DeviceDescriptor.idVendor, Child->m_DeviceDescriptor.idProduct)
	if (Init !=NULL) WdfDeviceInitFree(Init)
	if (Device !=NULL)
	if (Referenced) WdfObjectDereferenceWithTag(Child -> m_Object,(PVOID) HubTagPdo)
static PURB NTAPI	HubClientUrb (_In_ WDFREQUEST Request, _Out_ PULONG IoControlCode)
static VOID NTAPI	HubPatchFailedSelect (_In_ HubChild *Child, _Inout_ PURB Urb)
static WDFREQUEST NTAPI	HubTakeClientRequest (_In_ HubChild *Child)
static USBD_STATUS NTAPI	HubCheckConfigDescriptor (_In_ HubChild *Child, _In_ PUSB_CONFIGURATION_DESCRIPTOR Descriptor)
static BOOLEAN NTAPI	HubFailClientCheck (_In_ HubChild *Child, _In_ USBD_STATUS UsbdStatus)
static PUSB_INTERFACE_DESCRIPTOR NTAPI	HubFindSelectedInterface (_In_ PUSB_CONFIGURATION_DESCRIPTOR Config, _In_ UCHAR Number, _In_ UCHAR Alternate)
static USBD_STATUS NTAPI	HubInitInterfaceInformation (_In_ PUSB_CONFIGURATION_DESCRIPTOR Config, _Inout_ PUSBD_INTERFACE_INFORMATION Info)

Variables
static const char	HubTagPdo [] = "hub child pdo"
static const GUID	HubClassUnknown
static const GUID	HubCapFullSpeedCompatible
static const GUID	HubCapLowSpeedCompatible
static const DEVPROPKEY	HubKeyBillboardInfo
static const DEVPROPKEY	HubKeyDualRoleFeatures
static const DEVPROPKEY	HubKeyUsb4TunnelState
static const GUID	HubLpmDeviceSettings [HUB_PDO_LPM_SETTINGS]
static const GUID	HubLpmHubSettings [HUB_PDO_LPM_SETTINGS]
static PFN_HUB_SET_SYSTEM_WAKE_DEVICE	HubSetSystemWakeDevice
static BOOLEAN	HubSetSystemWakeDeviceResolved
static EVT_WDF_DEVICE_D0_ENTRY	HubPdoEvtD0Entry
static EVT_WDF_DEVICE_D0_EXIT	HubPdoEvtD0Exit
static EVT_WDF_DEVICE_PREPARE_HARDWARE	HubPdoEvtPrepareHardware
static EVT_WDF_DEVICE_RELEASE_HARDWARE	HubPdoEvtReleaseHardware
static EVT_WDF_DEVICE_SURPRISE_REMOVAL	HubPdoEvtSurpriseRemoval
static EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT	HubPdoEvtSelfManagedIoStart
static EVT_WDF_DEVICE_SELF_MANAGED_IO_SUSPEND	HubPdoEvtSelfManagedIoSuspend
static EVT_WDF_DEVICE_QUERY_STOP	HubPdoEvtQueryStop
static EVT_WDF_DEVICE_QUERY_REMOVE	HubPdoEvtQueryRemove
static EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS	HubPdoEvtEnableWakeAtBus
static EVT_WDF_DEVICE_DISABLE_WAKE_AT_BUS	HubPdoEvtDisableWakeAtBus
static EVT_WDF_DEVICE_REPORTED_MISSING	HubPdoEvtReportedMissing
static EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY	HubPdoEvtResourceRequirementsQuery
static EVT_WDF_OBJECT_CONTEXT_CLEANUP	HubPdoEvtCleanup
static EVT_WDFDEVICE_WDM_IRP_PREPROCESS	HubPdoPreprocessInternalIoctl
static EVT_WDFDEVICE_WDM_IRP_PREPROCESS	HubPdoPreprocessIoctl
static EVT_WDFDEVICE_WDM_IRP_PREPROCESS	HubPdoPreprocessPnp
static EVT_WDFDEVICE_WDM_IRP_PREPROCESS	HubPdoPreprocessSetPower
static EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST	HubPdoEvtParentInterfaceQuery
static EVT_WDF_IO_QUEUE_IO_INTERNAL_DEVICE_CONTROL	HubPdoEvtIoInternalDeviceControl
static EVT_WDF_IO_QUEUE_IO_DEVICE_CONTROL	HubPdoEvtIoDeviceControl
static EVT_WDF_WORKITEM	HubPdoEvtCompletePowerIrp
static EVT_WDF_REQUEST_COMPLETION_ROUTINE	HubPdoWakeNotificationComplete
static POWER_SETTING_CALLBACK	HubPdoLpmSettingChanged
_In_ DsmEvent	Event
_In_ DsmEvent _In_ PCSTR	What
KeClearEvent &	Child = Pdo->m_Child
return Child	m_PnpStatus
_Inout_ PIRP	Irp
_In_ BOOLEAN	D3ColdSupport
_In_ SYSTEM_POWER_STATE	SystemPowerState
_In_ SYSTEM_POWER_STATE _Out_ PDEVICE_WAKE_DEPTH	DeepestWakeableDstate
NTSTATUS	Status = Pdo->m_AcpiD3Cold.GetD3ColdCapability(Pdo->m_AcpiD3Cold.Context, D3ColdSupported)
	else
return	STATUS_SUCCESS
_Out_ PBOOLEAN	D3ColdSupported
_Out_ PD3COLD_LAST_TRANSITION_STATUS	LastTransitionStatus
_In_ PUNICODE_STRING	SymbolicLinkName
_Outptr_ PZZWSTR *	LocationStrings
const SIZE_T	Count = 10
PWCHAR	Buffer = (PWCHAR)ExAllocatePoolWithTag(PagedPool, Count * sizeof(WCHAR), HUB_TAG_DEVICE)
WDFDEVICE	HubDevice = Pdo->m_Hub->m_Device
_In_ WDFCMRESLIST	ResourcesRaw
_In_ WDFCMRESLIST _In_ WDFCMRESLIST	ResourcesTranslated
HubPdo *	Pdo = HubGetPdoContext(Device)
HubFdo *	Hub = Pdo->m_Hub
WDF_OBJECT_ATTRIBUTES	Attributes
const GUID *	InterfaceGuid
Pdo	m_FailRequests = TRUE
_In_ WDFIORESREQLIST	IoResourceRequirementsList
_In_ WDF_POWER_DEVICE_STATE	PreviousState
Pdo	m_WdfPowerState = WdfPowerDeviceD0
Pdo	m_PortNumber = Port->Number()
_In_ WDF_POWER_DEVICE_STATE	TargetState
POWER_ACTION	Action = WdfDeviceGetSystemPowerAction(Device)
_Inout_opt_ PHUB_DEVICE_CONFIG_INFO	Info
USB_ID_STRING	FriendlyName
Info	Version = 1
Info	Length = sizeof(*Info)
_Out_ WDFDEVICE *	Device
UNICODE_STRING	Name
ULONG	Index
Attributes	EvtCleanupCallback = HubPdoEvtCleanup
_In_ BOOLEAN	Known
HubPort *	Port = Child->m_Port
WDF_REMOVE_LOCK_OPTIONS	RemoveLock
PWDFDEVICE_INIT	Init = WdfPdoInitAllocate(Hub->m_Device)
BOOLEAN	Referenced = FALSE
Pdo	m_Device = Device
Pdo	m_Hub = Hub
Pdo	m_Child = Child
Pdo	m_ClientContractVersion = HUB_PDO_CONTRACT_UNKNOWN
Child	m_Pdo = Pdo
Pdo	m_Reported = TRUE
Child	m_LpmPolicy = HUB_LPM_POLICY_LINK_BITS
return	TRUE
Failed	__pad0__
return	FALSE

Macro Definition Documentation

HUB_DEVICE_CHARACTERISTICS_SIZE

#define HUB_DEVICE_CHARACTERISTICS_SIZE   0x18

Definition at line 46 of file childpdo.cpp.

HUB_IOCTL_GET_DEVICE_CHARACTERISTICS

#define HUB_IOCTL_GET_DEVICE_CHARACTERISTICS   HUB_USB_BUFFERED_IOCTL(USB_GET_DEVICE_CHARACTERISTICS)

Definition at line 42 of file childpdo.cpp.

HUB_IOCTL_GET_TIME_SYNC

#define HUB_IOCTL_GET_TIME_SYNC   HUB_USB_BUFFERED_IOCTL(USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC)

Definition at line 40 of file childpdo.cpp.

HUB_IOCTL_GET_TRANSPORT_CHARACTERISTICS

#define HUB_IOCTL_GET_TRANSPORT_CHARACTERISTICS   HUB_USB_BUFFERED_IOCTL(USB_GET_TRANSPORT_CHARACTERISTICS)

Definition at line 35 of file childpdo.cpp.

HUB_IOCTL_MEDIA_SERIAL_NUMBER

#define HUB_IOCTL_MEDIA_SERIAL_NUMBER   CTL_CODE(FILE_DEVICE_MASS_STORAGE, 0x0304, METHOD_BUFFERED, FILE_ANY_ACCESS)

Definition at line 50 of file childpdo.cpp.

HUB_IOCTL_NOTIFY_TRANSPORT_CHANGE

#define HUB_IOCTL_NOTIFY_TRANSPORT_CHANGE   HUB_USB_BUFFERED_IOCTL(USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE)

Definition at line 37 of file childpdo.cpp.

HUB_IOCTL_REGISTER_TRANSPORT_CHANGE

#define HUB_IOCTL_REGISTER_TRANSPORT_CHANGE   HUB_USB_BUFFERED_IOCTL(USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE)

Definition at line 36 of file childpdo.cpp.

HUB_IOCTL_START_TIME_SYNC

#define HUB_IOCTL_START_TIME_SYNC   HUB_USB_BUFFERED_IOCTL(USB_START_TRACKING_FOR_TIME_SYNC)

Definition at line 39 of file childpdo.cpp.

HUB_IOCTL_STOP_TIME_SYNC

#define HUB_IOCTL_STOP_TIME_SYNC   HUB_USB_BUFFERED_IOCTL(USB_STOP_TRACKING_FOR_TIME_SYNC)

Definition at line 41 of file childpdo.cpp.

HUB_IOCTL_UNREGISTER_TRANSPORT_CHANGE

#define HUB_IOCTL_UNREGISTER_TRANSPORT_CHANGE   HUB_USB_BUFFERED_IOCTL(USB_UNREGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE)

Definition at line 38 of file childpdo.cpp.

HUB_LPM_POLICY_LINK_BITS

#define HUB_LPM_POLICY_LINK_BITS

Value:

                                  (HUB_LPM_POLICY_U1_ENABLED | HUB_LPM_POLICY_U2_ENABLED | \
                                  HUB_LPM_POLICY_U1_ACCEPT | HUB_LPM_POLICY_U2_ACCEPT | \
                                  HUB_LPM_POLICY_U1_INITIATE | HUB_LPM_POLICY_U2_INITIATE)

Definition at line 139 of file childpdo.cpp.

HUB_MSOS20_SET_INDEX

#define HUB_MSOS20_SET_INDEX   7

Definition at line 29 of file childpdo.cpp.

HUB_PDO_DRIVER_WAIT_TIME

#define HUB_PDO_DRIVER_WAIT_TIME   10000

Definition at line 20 of file childpdo.cpp.

HUB_STAMPED_HANDLE_OFFSET

#define HUB_STAMPED_HANDLE_OFFSET   4

Definition at line 47 of file childpdo.cpp.

HUB_START_FAIL_MAX

#define HUB_START_FAIL_MAX   4096

Definition at line 53 of file childpdo.cpp.

HUB_TRANSPORT_REGISTRATION_SIZE

#define HUB_TRANSPORT_REGISTRATION_SIZE   (sizeof(ULONG) + sizeof(PVOID) + 24)

Definition at line 45 of file childpdo.cpp.

HUB_URB_FUNCTION_FAST_PATH_1

#define HUB_URB_FUNCTION_FAST_PATH_1   0x0039

Definition at line 24 of file childpdo.cpp.

HUB_URB_FUNCTION_FAST_PATH_2

#define HUB_URB_FUNCTION_FAST_PATH_2   0x003A

Definition at line 25 of file childpdo.cpp.

HUB_URB_FUNCTION_LAST

#define HUB_URB_FUNCTION_LAST   0x003C

Definition at line 23 of file childpdo.cpp.

HUB_URB_FUNCTION_SELECT_LIKE

#define HUB_URB_FUNCTION_SELECT_LIKE   0x003B

Definition at line 26 of file childpdo.cpp.

HUB_USB_BUFFERED_IOCTL

#define HUB_USB_BUFFERED_IOCTL

(

Function

)

CTL_CODE(FILE_DEVICE_USB, Function, METHOD_BUFFERED, FILE_ANY_ACCESS)

Definition at line 32 of file childpdo.cpp.

NDEBUG

#define NDEBUG

Definition at line 11 of file childpdo.cpp.

Typedef Documentation

PFN_HUB_SET_SYSTEM_WAKE_DEVICE

typedef VOID(NTAPI * PFN_HUB_SET_SYSTEM_WAKE_DEVICE) (_In_ PDEVICE_OBJECT DeviceObject)

Definition at line 145 of file childpdo.cpp.

Enumeration Type Documentation

HubLpmSlot

enum HubLpmSlot

Enumerator
HubLpmU1Enable
HubLpmU2Enable
HubLpmU1Timeout
HubLpmU2Timeout
HubLpmPolicy

Definition at line 130 of file childpdo.cpp.

{
    HubLpmU1Enable,
    HubLpmU2Enable,
    HubLpmU1Timeout,
    HubLpmU2Timeout,
    HubLpmPolicy
};

Function Documentation

_IRQL_requires_()

_IRQL_requires_

(

PASSIVE_LEVEL

)

Sends a synchronous IOCTL to the specified device object.

Lets KMDF handle the IRP, then hands it back here still uncompleted.

Definition at line 270 of file childpdo.cpp.

{
    PAGED_CODE();
 
    KeClearEvent(&Child->m_PreStartEvent);
    Child->Post(DsmEvent::PdoPreStart);
    HubWaitForPnpEvent(&Child->m_PreStartEvent, "PdoPreStart", Child->m_Object);
}

_IRQL_requires_max_() [1/2]

_IRQL_requires_max_

(

DISPATCH_LEVEL

)

Definition at line 818 of file childpdo.cpp.

{
    return ((HubPdo*)Context)->TestAndClearFlag(PdoFlag::ProgrammingLostOnReset);
}

_IRQL_requires_max_() [2/2]

_IRQL_requires_max_

(

PASSIVE_LEVEL

)

Definition at line 923 of file Messaging.c.

{
    PFLT_SERVER_PORT_OBJECT PortObject;
    NTSTATUS Status;
 
    /* The caller must allow at least one connection */
    if (MaxConnections == 0)
    {
        return STATUS_INVALID_PARAMETER;
    }
 
    /* The request must be for a kernel handle */
    if (!(ObjectAttributes->Attributes & OBJ_KERNEL_HANDLE))
    {
        return STATUS_INVALID_PARAMETER;
    }
 
    /*
     * Get rundown protection on the target to stop the owner
     * from unloading whilst this port object is open. It gets
     * removed in the FltpServerPortClose callback
     */
    Status = FltObjectReference(Filter);
    if (!NT_SUCCESS(Status))
    {
        return Status;
    }
 
    /* Create the server port object for this filter */
    Status = ObCreateObject(KernelMode,
                            ServerPortObjectType,
                            ObjectAttributes,
                            KernelMode,
                            NULL,
                            sizeof(FLT_SERVER_PORT_OBJECT),
                            0,
                            0,
                            (PVOID *)&PortObject);
    if (NT_SUCCESS(Status))
    {
        /* Zero out the struct */
        RtlZeroMemory(PortObject, sizeof(FLT_SERVER_PORT_OBJECT));
 
        /* Increment the ref count on the target filter */
        FltpObjectPointerReference((PFLT_OBJECT)Filter);
 
        /* Setup the filter port object */
        PortObject->Filter = Filter;
        PortObject->ConnectNotify = ConnectNotifyCallback;
        PortObject->DisconnectNotify = DisconnectNotifyCallback;
        PortObject->MessageNotify = MessageNotifyCallback;
        PortObject->Cookie = ServerPortCookie;
        PortObject->MaxConnections = MaxConnections;
 
        /* Insert the object */
        Status = ObInsertObject(PortObject,
                                NULL,
                                STANDARD_RIGHTS_ALL | FILE_READ_DATA,
                                0,
                                NULL,
                                (PHANDLE)ServerPort);
        if (NT_SUCCESS(Status))
        {
            /* Lock the connection list */
            ExAcquireFastMutex(&Filter->ConnectionList.mLock);
 
            /* Add the new port object to the connection list and increment the count */
            InsertTailList(&Filter->ConnectionList.mList, &PortObject->FilterLink);
            Filter->ConnectionList.mCount++;
 
            /* Unlock the connection list*/
            ExReleaseFastMutex(&Filter->ConnectionList.mLock);
        }
    }
 
    if (!NT_SUCCESS(Status))
    {
        /* Allow the filter to be cleaned up */
        FltObjectDereference(Filter);
    }
 
    return Status;
}

C_ASSERT() [1/2]

C_ASSERT

(

sizeof(HubBillboardHeader)

= =4

)

C_ASSERT() [2/2]

C_ASSERT

(

sizeof(HubBillboardMode)

= =8

)

ClearFlag()

Pdo ClearFlag

(

PdoFlag::Started

)

ClearState()

else Pdo m_Child ClearState

(

ChildState::D3ColdEnabledByDriver

)

DPRINT() [1/4]

DPRINT	(	"Child PDO %p on port %u D0 entry from %d\n"	,
		Device	,
		Pdo->	m_PortNumber,
		(int)	PreviousState
	)

DPRINT() [2/4]

DPRINT	(	"Child PDO %p on port %u D0 exit to %	d,
		action %d\n"	,
		Device	,
		Pdo->	m_PortNumber,
		(int)	TargetState,
		(int)	Action
	)

DPRINT() [3/4]

DPRINT	(	"Child PDO %p on port %u prepare hardware\n"	,
		Device	,
		Pdo->	m_PortNumber
	)

DPRINT() [4/4]

DPRINT	(	"Child PDO %p on port %u release hardware\n"	,
		Device	,
		Pdo->	m_PortNumber
	)

DPRINT1() [1/2]

DPRINT1	(	"Child PDO %p for port %	u,
		VID %04x PID %04x\n"	,
		Device	,
		Pdo->	m_PortNumber,
		Child->m_DeviceDescriptor.	idVendor,
		Child->m_DeviceDescriptor.	idProduct
	)

DPRINT1() [2/2]

DPRINT1	(	"Port %u device failed	enumeration,
		creating a placeholder PDO\n"	,
		Port->	Number()
	)

for()

for

(

Index

= 0;; Index++

)

Definition at line 3084 of file childpdo.cpp.

    {
        Status = RtlStringCchPrintfW(Buffer, RTL_NUMBER_OF(Buffer), L"\\Device\\USBPDO-%d", Index);
        if (!NT_SUCCESS(Status))
            return Status;
 
        RtlInitUnicodeString(&Name, Buffer);
        Status = WdfDeviceInitAssignName(*Init, &Name);
        if (!NT_SUCCESS(Status))
            return Status;
 
        Status = WdfDeviceCreate(Init, &Attributes, Device);
        if (Status != STATUS_OBJECT_NAME_COLLISION)
            return Status;
 
        DPRINT("PDO name %wZ is taken, trying the next\n", &Name);
    }

HubCacheMsOs20SetInfo()

HubCacheMsOs20SetInfo

(

Child

)

HubCheckConfigDescriptor()

static USBD_STATUS NTAPI HubCheckConfigDescriptor ( _In_ HubChild *  Child, _In_ PUSB_CONFIGURATION_DESCRIPTOR  Descriptor  )

static

Definition at line 3570 of file childpdo.cpp.

{
    HubDescContext Context;
    volatile UCHAR Touch;
 
    if (Descriptor->bDescriptorType != USB_CONFIGURATION_DESCRIPTOR_TYPE ||
        Descriptor->bLength < sizeof(*Descriptor) ||
        Descriptor->wTotalLength == 0)
    {
        return USBD_STATUS_INVALID_CONFIGURATION_DESCRIPTOR;
    }
 
    /* A bad client buffer faults here rather than deep in the validator */
    Touch = ((volatile UCHAR*)Descriptor)[0];
    Touch = ((volatile UCHAR*)Descriptor)[Descriptor->wTotalLength - 1];
    (VOID)Touch;
 
    HubDescInitDeviceContext(&Context,
                             Child->m_DeviceDescriptor.bcdUSB,
                             Child->Speed(),
                             Child->HasHack(ChildHack::UseWin8DescriptorValidation),
                             Child->m_Port->m_Info.SspIsochBurstCount,
                             Child->m_ValidationBits);
 
    if (!HubDescCheckConfiguration(&Context, Descriptor, Descriptor->wTotalLength, NULL))
        return USBD_STATUS_INVALID_CONFIGURATION_DESCRIPTOR;
 
    return USBD_STATUS_SUCCESS;
}

Referenced by DeviceMachine::SelectConfigValid().

HubClientUrb()

static PURB NTAPI HubClientUrb ( _In_ WDFREQUEST  Request, _Out_ PULONG  IoControlCode  )

static

Definition at line 3416 of file childpdo.cpp.

{
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(WdfRequestWdmGetIrp(Request));
 
    *IoControlCode = Stack->Parameters.DeviceIoControl.IoControlCode;
    if (*IoControlCode != IOCTL_INTERNAL_USB_SUBMIT_URB)
        return NULL;
 
    return (PURB)Stack->Parameters.Others.Argument1;
}

Referenced by DeviceMachine::CompleteClientRequest(), DeviceMachine::CompleteClientRequestFailed(), DeviceMachine::CompleteClientRequestLastStatus(), DeviceMachine::FindClientPipe(), DeviceMachine::SelectConfigValid(), and DeviceMachine::SelectInterfaceValid().

HubD3ColdDereference()

static VOID NTAPI HubD3ColdDereference ( _In_ PVOID  Context )

static

Definition at line 522 of file childpdo.cpp.

{
    HubPdo* Pdo = (HubPdo*)Context;
 
    if (Pdo->m_AcpiD3Cold.InterfaceDereference != NULL)
        Pdo->m_AcpiD3Cold.InterfaceDereference(Pdo->m_AcpiD3Cold.Context);
}

Referenced by HubPdoAnswerD3Cold().

HubD3ColdReference()

static VOID NTAPI HubD3ColdReference ( _In_ PVOID  Context )

static

Definition at line 510 of file childpdo.cpp.

{
    HubPdo* Pdo = (HubPdo*)Context;
 
    if (Pdo->m_AcpiD3Cold.InterfaceReference != NULL)
        Pdo->m_AcpiD3Cold.InterfaceReference(Pdo->m_AcpiD3Cold.Context);
}

Referenced by HubPdoAnswerD3Cold().

HubEvtBandwidthRetryTimer()

VOID NTAPI HubEvtBandwidthRetryTimer

(

_In_ WDFTIMER

Timer

)

Definition at line 2938 of file childpdo.cpp.

{
    HubPort* Port = HubPort::FromObject(WdfTimerGetParentObject(Timer));
    HubChild* Child = Port->m_Child;
 
    /* The timer outlives a device that left the port; only the current one reports */
    if (Child == NULL || Child->m_BandwidthRetryTimer != Timer)
        return;
 
    DPRINT1("Port %u ran out of bandwidth\n", Port->Number());
    HubWmiNotifyInsufficientBandwidth(Port->m_Hub, Port->Number());
}

HubFailClientCheck()

static BOOLEAN NTAPI HubFailClientCheck ( _In_ HubChild *  Child, _In_ USBD_STATUS  UsbdStatus  )

static

Definition at line 3605 of file childpdo.cpp.

{
    Child->m_LastUsbdStatus = UsbdStatus;
    Child->m_LastNtStatus = HubUsbdStatusToNt(UsbdStatus);
    DPRINT1("Port %u client select check failed, USBD status 0x%lx\n", Child->m_Port->Number(), UsbdStatus);
    return FALSE;
}

Referenced by DeviceMachine::SelectConfigValid(), and DeviceMachine::SelectInterfaceValid().

HubFindSelectedInterface()

static PUSB_INTERFACE_DESCRIPTOR NTAPI HubFindSelectedInterface ( _In_ PUSB_CONFIGURATION_DESCRIPTOR  Config, _In_ UCHAR  Number, _In_ UCHAR  Alternate  )

static

Definition at line 3692 of file childpdo.cpp.

{
    PUCHAR Position = (PUCHAR)Config;
    PUCHAR End;
    PUSB_COMMON_DESCRIPTOR Common;
    PUSB_INTERFACE_DESCRIPTOR Interface;
    PUSB_INTERFACE_DESCRIPTOR Found = NULL;
    BOOLEAN NumberSeen = FALSE;
    ULONG Endpoints = 0;
 
    if (Config->bLength < sizeof(*Config) ||
        Config->bDescriptorType != USB_CONFIGURATION_DESCRIPTOR_TYPE ||
        Config->wTotalLength < sizeof(*Config))
    {
        return NULL;
    }
 
    End = Position + Config->wTotalLength;
 
    for (; Position + sizeof(*Common) <= End; Position += Common->bLength)
    {
        Common = (PUSB_COMMON_DESCRIPTOR)Position;
        if (Common->bLength == 0 || Position + Common->bLength > End)
            break;
 
        if (Common->bDescriptorType == USB_INTERFACE_DESCRIPTOR_TYPE)
        {
            if (Common->bLength < sizeof(*Interface))
                continue;
 
            Interface = (PUSB_INTERFACE_DESCRIPTOR)Common;
            if (Interface->bInterfaceNumber != Number)
            {
                if (NumberSeen)
                    break;
                continue;
            }
 
            NumberSeen = TRUE;
            if (Found != NULL)
                break;
            if (Interface->bAlternateSetting == Alternate)
                Found = Interface;
        }
        else if (Common->bDescriptorType == USB_ENDPOINT_DESCRIPTOR_TYPE && Found != NULL)
        {
            if (Common->bLength < sizeof(USB_ENDPOINT_DESCRIPTOR))
                return NULL;
            Endpoints++;
        }
    }
 
    if (Found != NULL && Found->bNumEndpoints > Endpoints)
        return NULL;
 
    return Found;
}

Referenced by HubInitInterfaceInformation().

HubFlushSqmFlags()

HubFlushSqmFlags

(

Child

)

Referenced by if().

HubInitInterfaceInformation()

static USBD_STATUS NTAPI HubInitInterfaceInformation ( _In_ PUSB_CONFIGURATION_DESCRIPTOR  Config, _Inout_ PUSBD_INTERFACE_INFORMATION  Info  )

static

Definition at line 3757 of file childpdo.cpp.

{
    PUSB_INTERFACE_DESCRIPTOR Descriptor;
    PUSBD_PIPE_INFORMATION Pipe;
    PUCHAR Position;
    USBD_STATUS Status = USBD_STATUS_SUCCESS;
    ULONG Needed;
    ULONG Index;
 
    Descriptor = HubFindSelectedInterface(Config, Info->InterfaceNumber, Info->AlternateSetting);
    if (Descriptor == NULL)
    {
        Info->Length = 0;
        return USBD_STATUS_INTERFACE_NOT_FOUND;
    }
 
    Needed = FIELD_OFFSET(USBD_INTERFACE_INFORMATION, Pipes) +
             Descriptor->bNumEndpoints * sizeof(USBD_PIPE_INFORMATION);
 
    if (Info->Length < Needed)
    {
        Info->Length = (USHORT)Needed;
        return USBD_STATUS_BUFFER_TOO_SMALL;
    }
 
    Info->Class = Descriptor->bInterfaceClass;
    Info->SubClass = Descriptor->bInterfaceSubClass;
    Info->Protocol = Descriptor->bInterfaceProtocol;
    Info->Reserved = 0;
    Info->InterfaceHandle = NULL;
    Info->NumberOfPipes = Descriptor->bNumEndpoints;
 
    Position = (PUCHAR)Descriptor;
    for (Index = 0; Index < Descriptor->bNumEndpoints; Index++)
    {
        /* HubFindSelectedInterface proved this many endpoints follow */
        do
        {
            Position += ((PUSB_COMMON_DESCRIPTOR)Position)->bLength;
        } while (((PUSB_COMMON_DESCRIPTOR)Position)->bDescriptorType != USB_ENDPOINT_DESCRIPTOR_TYPE);
 
        Pipe = &Info->Pipes[Index];
        Pipe->EndpointAddress = ((PUSB_ENDPOINT_DESCRIPTOR)Position)->bEndpointAddress;
        Pipe->Interval = ((PUSB_ENDPOINT_DESCRIPTOR)Position)->bInterval;
        Pipe->PipeType = UsbdPipeTypeControl;
        Pipe->PipeHandle = NULL;
 
        if (Pipe->PipeFlags & ~USBD_PF_VALID_MASK)
            Status = USBD_STATUS_INVALID_PIPE_FLAGS;
 
        if (!(Pipe->PipeFlags & USBD_PF_CHANGE_MAX_PACKET))
            Pipe->MaximumPacketSize = 0;
    }
 
    Info->Length = (USHORT)Needed;
    return Status;
}

Referenced by DeviceMachine::SelectInterfaceValid().

HubNoPingResponse()

VOID NTAPI HubNoPingResponse	(	_In_ UCXHUB_HUB_CONTEXT	HubContext,
		_In_ UCXHUB_DEVICE_CONTEXT	DeviceContext
	)

Definition at line 2955 of file childpdo.cpp.

{
    UNREFERENCED_PARAMETER(HubContext);
 
    DPRINT1("Device %p did not answer a ping\n", DeviceContext);
    ((HubChild*)DeviceContext)->Post(DsmEvent::NoPingResponse);
}

HubNtStatusToUsbd()

USBD_STATUS NTAPI HubNtStatusToUsbd

(

_In_ NTSTATUS

Status

)

NT to USBD status mapping shared by the hub and the child PDO.

Definition at line 190 of file childpdo.cpp.

{
    switch (Status)
    {
        case STATUS_SUCCESS:
            return USBD_STATUS_SUCCESS;
 
        /* The first one is the hub's own addition to the shared table */
        case STATUS_DEVICE_NOT_CONNECTED:
        case STATUS_NO_SUCH_DEVICE:
            return USBD_STATUS_DEVICE_GONE;
 
        case STATUS_INSUFFICIENT_RESOURCES:
            return USBD_STATUS_INSUFFICIENT_RESOURCES;
 
        case STATUS_NOT_SUPPORTED:
            return USBD_STATUS_NOT_SUPPORTED;
 
        case STATUS_CANCELLED:
            return USBD_STATUS_CANCELED;
 
        default:
            return USBD_STATUS_INVALID_PARAMETER;
    }
}

Referenced by DeviceMachine::CompleteClientRequestFailed(), HubChildConfigureDone(), HubChildRecordFailure(), HubChildSubmitUcxIoctl(), HubChildUcxIoctlComplete(), HubPdoSyncComplete(), and DeviceMachine::NotifyDeviceReset().

HubPatchFailedSelect()

static VOID NTAPI HubPatchFailedSelect ( _In_ HubChild *  Child, _Inout_ PURB  Urb  )

static

Definition at line 3433 of file childpdo.cpp.

{
    if (Urb->UrbHeader.Function == URB_FUNCTION_SELECT_INTERFACE)
    {
        Child->SetState(ChildState::ConfigurationValid);
        Urb->UrbSelectInterface.Interface.InterfaceHandle = (USBD_INTERFACE_HANDLE)(LONG_PTR)-1;
    }
    else if (Urb->UrbHeader.Function == URB_FUNCTION_SELECT_CONFIGURATION)
    {
        Urb->UrbSelectConfiguration.ConfigurationHandle = NULL;
    }
}

Referenced by DeviceMachine::CompleteClientRequestFailed(), and DeviceMachine::CompleteClientRequestLastStatus().

HubPdoAnswerD3Cold()

static NTSTATUS NTAPI HubPdoAnswerD3Cold ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp  )

static

Definition at line 721 of file childpdo.cpp.

{
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(Irp);
    PD3COLD_SUPPORT_INTERFACE Interface = (PD3COLD_SUPPORT_INTERFACE)Stack->Parameters.QueryInterface.Interface;
 
    if (Stack->Parameters.QueryInterface.Size != sizeof(*Interface) ||
        Stack->Parameters.QueryInterface.Version != 1)
    {
        DPRINT("D3cold query on port %u with size %u version %u left alone\n",
               Pdo->m_PortNumber, Stack->Parameters.QueryInterface.Size, Stack->Parameters.QueryInterface.Version);
        return HubPdoCompleteAsIs(Irp);
    }
 
    /* An ACPI filter above already filled it on the way down; keep its copy */
    if (Irp->IoStatus.Status == STATUS_SUCCESS)
    {
        if (Interface->Size != sizeof(*Interface) || Interface->Version != 1)
        {
            DPRINT1("ACPI D3cold interface on port %u has size %u version %u\n",
                    Pdo->m_PortNumber, Interface->Size, Interface->Version);
            return HubPdoCompleteIrp(Irp, STATUS_NOT_SUPPORTED);
        }
 
        Pdo->m_AcpiD3Cold = *Interface;
    }
    else
    {
        Interface->Size = sizeof(*Interface);
        Interface->Version = 1;
    }
 
    Interface->Context = Pdo;
    Interface->InterfaceReference = HubD3ColdReference;
    Interface->InterfaceDereference = HubD3ColdDereference;
    Interface->SetD3ColdSupport = HubD3ColdSetSupport;
    Interface->GetIdleWakeInfo = HubD3ColdGetIdleWakeInfo;
    Interface->GetD3ColdCapability = HubD3ColdGetCapability;
    Interface->GetBusDriverD3ColdSupport = HubD3ColdGetBusDriverSupport;
    Interface->GetLastTransitionStatus = HubD3ColdGetLastTransition;
 
    return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
}

Referenced by HubPdoQueryInterface().

HubPdoCachedDescriptor()

static NTSTATUS NTAPI HubPdoCachedDescriptor ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp, _Inout_ PURB  Urb  )

static

Definition at line 2000 of file childpdo.cpp.

{
    struct _URB_CONTROL_DESCRIPTOR_REQUEST* Request = &Urb->UrbControlDescriptorRequest;
    HubChild* Child = Pdo->m_Child;
    PVOID Source;
    PVOID Buffer;
    ULONG Size;
    NTSTATUS Status;
 
    if (Child->m_DeviceDescriptor.bcdUSB <= 0x0200)
    {
        HubPdoStampUrb(Pdo, Urb);
        return HubPdoToController(Pdo, Irp);
    }
 
    Status = HubPdoValidateUrb(Urb);
    if (!NT_SUCCESS(Status))
        return HubPdoCompleteIrp(Irp, Status);
 
    Buffer = HubPdoUrbBuffer(Request->TransferBuffer, Request->TransferBufferMDL);
    if (Buffer == NULL)
    {
        DPRINT1("Port %u descriptor URB %p has no buffer\n", Pdo->m_PortNumber, Urb);
        Urb->UrbHeader.Status = USBD_STATUS_INVALID_PARAMETER;
        return HubPdoCompleteIrp(Irp, STATUS_INVALID_PARAMETER);
    }
 
    if (Request->DescriptorType == USB_DEVICE_DESCRIPTOR_TYPE)
    {
        Source = &Child->m_DeviceDescriptor;
        Size = min(sizeof(Child->m_DeviceDescriptor), Request->TransferBufferLength);
    }
    else if (Request->DescriptorType == USB_CONFIGURATION_DESCRIPTOR_TYPE &&
             Request->Index == 0 &&
             Child->m_ConfigDescriptor != NULL)
    {
        Source = Child->m_ConfigDescriptor;
        Size = min((ULONG)Child->m_ConfigDescriptor->wTotalLength, Request->TransferBufferLength);
    }
    else
    {
        HubPdoStampUrb(Pdo, Urb);
        return HubPdoToController(Pdo, Irp);
    }
 
    /* Compat: a default pipe request reads back as a control transfer */
    Urb->UrbControlTransfer.TransferFlags |= USBD_TRANSFER_DIRECTION_IN;
    if (Urb->UrbControlTransfer.TransferFlags & USBD_DEFAULT_PIPE_TRANSFER)
        Urb->UrbHeader.Function = URB_FUNCTION_CONTROL_TRANSFER;
 
    RtlCopyMemory(Buffer, Source, Size);
    Request->TransferBufferLength = Size;
    return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
}

Referenced by HubPdoRouteUrb().

HubPdoCompleteAsIs()

static NTSTATUS NTAPI HubPdoCompleteAsIs ( _Inout_ PIRP  Irp )

static

Completes with whatever status the IRP already carries.

Definition at line 300 of file childpdo.cpp.

{
    NTSTATUS Status = Irp->IoStatus.Status;
 
    IoCompleteRequest(Irp, IO_NO_INCREMENT);
    return Status;
}

Referenced by HubPdoAnswerD3Cold(), HubPdoDispatchIoctl(), HubPdoPreprocessPnp(), and HubPdoQueryInterface().

HubPdoCompleteIrp()

static NTSTATUS NTAPI HubPdoCompleteIrp ( _Inout_ PIRP  Irp, _In_ NTSTATUS  Status  )

static

Definition at line 287 of file childpdo.cpp.

{
    Irp->IoStatus.Status = Status;
    IoCompleteRequest(Irp, IO_NO_INCREMENT);
    return Status;
}

Referenced by HubPdoAnswerD3Cold(), HubPdoCachedDescriptor(), HubPdoCyclePort(), HubPdoDispatchIoctl(), HubPdoForwardSelectLike(), HubPdoGetHubName(), HubPdoMsFeatureDescriptor(), HubPdoPreprocessInternalIoctl(), HubPdoPreprocessPnp(), HubPdoQueryCapability(), HubPdoRouteUrb(), HubPdoStampAndForward(), and HubPdoToController().

HubPdoCyclePort()

static NTSTATUS NTAPI HubPdoCyclePort ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp  )

static

Definition at line 2526 of file childpdo.cpp.

{
    if (KeGetCurrentIrql() > PASSIVE_LEVEL)
    {
        DPRINT1("Port %u cycle request above passive level\n", Pdo->m_PortNumber);
        return HubPdoCompleteIrp(Irp, STATUS_INVALID_PARAMETER);
    }
 
    if (InterlockedCompareExchange(&Pdo->m_CycleQueued, 1, 0) == 0)
    {
        DPRINT1("Client cycles port %u\n", Pdo->m_PortNumber);
        Pdo->m_Child->Post(DsmEvent::ClientCyclePort);
    }
    else
    {
        DPRINT1("Port %u cycle ignored, one was already requested\n", Pdo->m_PortNumber);
    }
 
    return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
}

Referenced by HubPdoDispatchIoctl().

HubPdoDispatchIoctl()

static NTSTATUS NTAPI HubPdoDispatchIoctl ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp  )

static

Definition at line 2553 of file childpdo.cpp.

{
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(Irp);
    PVOID Argument1 = Stack->Parameters.Others.Argument1;
    HubChild* Child = Pdo->m_Child;
    PREGISTER_COMPOSITE_DEVICE Composite;
    PUCXHUB_DUMP_DEVICE_INFO Dump;
    PULONG PortStatus;
    ULONG Code = Stack->Parameters.DeviceIoControl.IoControlCode;
    NTSTATUS Status;
 
    switch (Code)
    {
        case IOCTL_INTERNAL_USB_RESET_PORT:
            if (!Pdo->HasFlag(PdoFlag::InD0))
            {
                DPRINT1("Port %u reset refused, the device is not in D0\n", Pdo->m_PortNumber);
                return HubPdoCompleteIrp(Irp, STATUS_POWER_STATE_INVALID);
            }
            if (KeGetCurrentIrql() > PASSIVE_LEVEL)
            {
                DPRINT1("Port %u reset requested above passive level\n", Pdo->m_PortNumber);
                return HubPdoCompleteIrp(Irp, STATUS_INVALID_PARAMETER);
            }
            return HubPdoQueueAndWait(Pdo, Irp, Pdo->m_Queue);
 
        case IOCTL_UCXHUB_RESET_PORT_ASYNC:
            if (!Pdo->HasFlag(PdoFlag::InD0))
            {
                DPRINT1("Port %u async reset refused, the device is not in D0\n", Pdo->m_PortNumber);
                return HubPdoCompleteIrp(Irp, STATUS_POWER_STATE_INVALID);
            }
            if (KeGetCurrentIrql() > DISPATCH_LEVEL)
            {
                DPRINT1("Port %u async reset requested above dispatch level\n", Pdo->m_PortNumber);
                return HubPdoCompleteIrp(Irp, STATUS_INVALID_PARAMETER);
            }
            return HubPdoQueueAsync(Pdo, Irp);
 
        case IOCTL_INTERNAL_USB_GET_PORT_STATUS:
            PortStatus = (PULONG)Argument1;
            if (KeGetCurrentIrql() > PASSIVE_LEVEL || PortStatus == NULL)
            {
                DPRINT1("Port %u status request refused, buffer %p\n", Pdo->m_PortNumber, PortStatus);
                return HubPdoCompleteIrp(Irp, STATUS_INVALID_PARAMETER);
            }
 
            /* The hub machine reads the port and clears ReportPortDisabled through Argument2 */
            *PortStatus = 0;
            Stack->Parameters.Others.Argument2 = Pdo;
            return HubPdoQueueAndWait(Pdo, Irp, WdfDeviceGetDefaultQueue(Pdo->m_Hub->m_Device));
 
        case IOCTL_INTERNAL_USB_ENABLE_PORT:
        case IOCTL_INTERNAL_USB_GET_HUB_COUNT:
            return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
 
        case IOCTL_INTERNAL_USB_CYCLE_PORT:
            return HubPdoCyclePort(Pdo, Irp);
 
        case IOCTL_INTERNAL_USB_GET_HUB_NAME:
            return HubPdoGetHubName(Pdo, Irp);
 
        case IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION:
            return HubPdoSubmitIdleRequest(Pdo, Irp);
 
        case IOCTL_INTERNAL_USB_RECORD_FAILURE:
            return HubPdoCompleteIrp(Irp, HubPdoRecordFailure(Pdo, (HubStartFailHeader*)Argument1));
 
        case IOCTL_INTERNAL_USB_GET_BUS_INFO:
            return HubPdoCompleteIrp(Irp, HubQueryDeviceBusInfo(Child, (PUSB_BUS_NOTIFICATION)Argument1));
 
        case IOCTL_INTERNAL_USB_GET_CONTROLLER_NAME:
            return HubPdoCompleteIrp(Irp, HubQueryControllerName(Pdo->m_Hub,
                                                                 (PUSB_HUB_NAME)Argument1,
                                                                 (ULONG)(ULONG_PTR)Stack->Parameters.Others.Argument2));
 
        case IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE:
            if (Argument1 == NULL)
            {
                DPRINT1("Port %u device handle request has no buffer\n", Pdo->m_PortNumber);
                return HubPdoCompleteIrp(Irp, STATUS_INVALID_PARAMETER);
            }
            return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
 
        case IOCTL_INTERNAL_USB_GET_ROOTHUB_PDO:
        case IOCTL_INTERNAL_USB_GET_PARENT_HUB_INFO:
        case IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE_EX:
        case IOCTL_INTERNAL_USB_GET_TT_DEVICE_HANDLE:
        case IOCTL_INTERNAL_USB_NOTIFY_IDLE_READY:
            DPRINT1("Port %u internal IOCTL 0x%lx is not supported\n", Pdo->m_PortNumber, Code);
            return HubPdoCompleteIrp(Irp, STATUS_NOT_SUPPORTED);
 
        case IOCTL_INTERNAL_USB_GET_TOPOLOGY_ADDRESS:
            return HubPdoCompleteIrp(Irp, HubPdoTopologyAddress(Pdo, (PUSB_TOPOLOGY_ADDRESS)Argument1));
 
        case IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO:
            return HubPdoCompleteIrp(Irp, HubPdoDeviceConfigInfo(Pdo, (PHUB_DEVICE_CONFIG_INFO)Argument1));
 
        case IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE:
            Composite = (PREGISTER_COMPOSITE_DEVICE)Argument1;
            Stack->Parameters.Others.Argument2 = Child->m_UsbDevice;
            if (Composite != NULL && Composite->CapabilityFlags.CapabilityFunctionSuspend)
                Pdo->SetFlag(PdoFlag::ClientDoesFunctionSuspend);
            return HubPdoToController(Pdo, Irp);
 
        case IOCTL_INTERNAL_USB_UNREGISTER_COMPOSITE_DEVICE:
        case IOCTL_INTERNAL_USB_REQUEST_REMOTE_WAKE_NOTIFICATION:
        case IOCTL_UCXHUB_SET_FUNCTION_HANDLE_DATA:
            Stack->Parameters.Others.Argument2 = Child->m_UsbDevice;
            return HubPdoToController(Pdo, Irp);
 
        case IOCTL_UCXHUB_GET_HUB_INFO:
            HubPdoFillHubInfo(Pdo, (HubParentInfo*)Argument1);
            return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
 
        case IOCTL_UCXHUB_QUERY_USB_CAPABILITY:
            return HubPdoQueryCapability(Pdo, Irp, (PUCXHUB_QUERY_CAPABILITY)Argument1);
 
        case IOCTL_UCXHUB_GET_DUMP_DATA:
            Dump = (PUCXHUB_DUMP_DEVICE_INFO)Irp->AssociatedIrp.SystemBuffer;
            Dump->Device = Child->m_UsbDevice;
            return HubPdoToController(Pdo, Irp);
 
        case IOCTL_UCXHUB_FREE_DUMP_DATA:
            return HubPdoToController(Pdo, Irp);
 
        case IOCTL_UCXHUB_NOTIFY_FORWARD_PROGRESS:
            ((PUCXHUB_FORWARD_PROGRESS_INFO)Argument1)->Device = Child->m_UsbDevice;
            return HubPdoToController(Pdo, Irp);
 
        default:
            Status = Irp->IoStatus.Status;
            if (!NT_SUCCESS(Status))
                DPRINT1("Port %u unknown internal IOCTL 0x%lx completed 0x%lx\n", Pdo->m_PortNumber, Code, Status);
            return HubPdoCompleteAsIs(Irp);
    }
}

Referenced by HubPdoPreprocessInternalIoctl().

HubPdoEvtCompletePowerIrp()

static VOID NTAPI HubPdoEvtCompletePowerIrp ( _In_ WDFWORKITEM  WorkItem )

static

Definition at line 1087 of file childpdo.cpp.

{
    IoCompleteRequest(HubGetPdoIrpWork(WorkItem)->Irp, IO_NO_INCREMENT);
    WdfObjectDelete(WorkItem);
}

HubPdoEvtEnableWakeAtBus()

static NTSTATUS NTAPI HubPdoEvtEnableWakeAtBus ( _In_ WDFDEVICE  Device, _In_ SYSTEM_POWER_STATE  PowerState  )

static

Definition at line 1676 of file childpdo.cpp.

{
    HubPdo* Pdo = HubGetPdoContext(Device);
    HubChild* Child = Pdo->m_Child;
    NTSTATUS Status = STATUS_SUCCESS;
 
    DPRINT("Port %u enable wake for S%d\n", Pdo->m_PortNumber, (int)PowerState - 1);
 
    Pdo->SetFlag(PdoFlag::WaitWakePending);
 
    /* Hubs pass their children's wake on but are not armed for Sx here */
    if (Child->HasProperty(ChildProperty::IsHub) && PowerState != PowerSystemWorking)
        return STATUS_SUCCESS;
 
    if (!Child->HasProperty(ChildProperty::RemoteWakeCapable))
    {
        DPRINT1("Port %u device cannot wake\n", Pdo->m_PortNumber);
        return STATUS_NOT_SUPPORTED;
    }
 
    if (Pdo->HasFlag(PdoFlag::ClientDoesFunctionSuspend))
        return STATUS_SUCCESS;
 
    if (Child->m_Kind & DSM_KIND_SUPER_SPEED)
    {
        Status = HubPdoSendWakeNotification(Pdo);
        if (NT_SUCCESS(Status))
            Pdo->SetFlag(PdoFlag::WakeNotificationSent);
    }
 
    Pdo->SetFlag(PdoFlag::WakeArmRequested);
    return Status;
}

HubPdoEvtIoDeviceControl()

static VOID NTAPI HubPdoEvtIoDeviceControl ( _In_ WDFQUEUE  Queue, _In_ WDFREQUEST  Request, _In_ size_t  OutputBufferLength, _In_ size_t  InputBufferLength, _In_ ULONG  IoControlCode  )

static

Definition at line 2908 of file childpdo.cpp.

{
    PIRP Irp = WdfRequestWdmGetIrp(Request);
 
    UNREFERENCED_PARAMETER(Queue);
    UNREFERENCED_PARAMETER(OutputBufferLength);
    UNREFERENCED_PARAMETER(InputBufferLength);
 
    switch (IoControlCode)
    {
        case HUB_IOCTL_MEDIA_SERIAL_NUMBER:
            DPRINT("Media serial number request on a USB PDO is not supported\n");
            WdfRequestComplete(Request, STATUS_NOT_SUPPORTED);
            break;
 
        default:
            DPRINT("PDO IOCTL 0x%lx completed 0x%lx\n", IoControlCode, Irp->IoStatus.Status);
            WdfRequestComplete(Request, Irp->IoStatus.Status);
            break;
    }
}

HubPdoEvtIoInternalDeviceControl()

static VOID NTAPI HubPdoEvtIoInternalDeviceControl ( _In_ WDFQUEUE  Queue, _In_ WDFREQUEST  Request, _In_ size_t  OutputBufferLength, _In_ size_t  InputBufferLength, _In_ ULONG  IoControlCode  )

static

Definition at line 2815 of file childpdo.cpp.

{
    HubPdo* Pdo = HubGetPdoContext(WdfIoQueueGetDevice(Queue));
    HubChild* Child = Pdo->m_Child;
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(WdfRequestWdmGetIrp(Request));
    PURB Urb;
    DsmEvent Event = DsmEvent::Count;
 
    UNREFERENCED_PARAMETER(OutputBufferLength);
    UNREFERENCED_PARAMETER(InputBufferLength);
 
    switch (IoControlCode)
    {
        case IOCTL_INTERNAL_USB_SUBMIT_URB:
            Urb = (PURB)Stack->Parameters.Others.Argument1;
 
            switch (Urb->UrbHeader.Function)
            {
                /* The device handle goes in; an unconfigure drops the handle */
                case URB_FUNCTION_SELECT_CONFIGURATION:
                    Urb->UrbHeader.UsbdDeviceHandle = Child->m_UsbDevice;
                    if (Urb->UrbSelectConfiguration.ConfigurationDescriptor == NULL)
                    {
                        Urb->UrbSelectConfiguration.ConfigurationHandle = NULL;
                        Event = DsmEvent::ClientUnconfigure;
                    }
                    else
                    {
                        Event = DsmEvent::ClientSelectConfig;
                    }
                    break;
 
                case URB_FUNCTION_SELECT_INTERFACE:
                    Event = DsmEvent::ClientSetInterface;
                    break;
 
                case URB_FUNCTION_SYNC_RESET_PIPE_AND_CLEAR_STALL:
                    DPRINT1("Client resets pipe %p on port %u\n", Urb->UrbPipeRequest.PipeHandle, Pdo->m_PortNumber);
                    Event = DsmEvent::ClientResetPipe;
                    break;
 
                case URB_FUNCTION_SYNC_RESET_PIPE:
                    DPRINT1("Client sync resets pipe %p on port %u\n", Urb->UrbPipeRequest.PipeHandle, Pdo->m_PortNumber);
                    Event = DsmEvent::ClientSyncResetPipe;
                    break;
 
                case URB_FUNCTION_SYNC_CLEAR_STALL:
                    DPRINT1("Client clears stall on pipe %p on port %u\n", Urb->UrbPipeRequest.PipeHandle, Pdo->m_PortNumber);
                    Event = DsmEvent::ClientClearStall;
                    break;
 
                case URB_FUNCTION_OPEN_STATIC_STREAMS:
                case URB_FUNCTION_CLOSE_STATIC_STREAMS:
                    Event = DsmEvent::ClientStreams;
                    break;
 
                default:
                    break;
            }
            break;
 
        case IOCTL_INTERNAL_USB_RESET_PORT:
        case IOCTL_UCXHUB_RESET_PORT_ASYNC:
            DPRINT1("Client reset of port %u starts\n", Pdo->m_PortNumber);
            Child->m_Port->m_ConnectionStatus = DeviceReset;
            Event = DsmEvent::ClientResetDevice;
            break;
 
        default:
            break;
    }
 
    if (Event == DsmEvent::Count)
    {
        DPRINT1("Port %u queue got IOCTL 0x%lx it cannot handle\n", Pdo->m_PortNumber, IoControlCode);
        WdfRequestComplete(Request, STATUS_NOT_SUPPORTED);
        return;
    }
 
    DPRINT("Port %u client request %p, IOCTL 0x%lx\n", Pdo->m_PortNumber, Request, IoControlCode);
    Child->m_ClientRequest = Request;
    Child->Post(Event);
}

HubPdoEvtParentInterfaceQuery()

static NTSTATUS NTAPI HubPdoEvtParentInterfaceQuery ( _In_ WDFDEVICE  Device, _In_ LPGUID  InterfaceType, _Inout_ PINTERFACE  ExposedInterface, _Inout_opt_ PVOID  ExposedInterfaceSpecificData  )

static

Definition at line 876 of file childpdo.cpp.

{
    HubPdo* Pdo = HubGetPdoContext(Device);
    HubChild* Child = Pdo->m_Child;
    HubFdo* Hub = Pdo->m_Hub;
    HubPort* Port = Child->m_Port;
    PUCXHUB_PARENT_INTERFACE Parent = (PUCXHUB_PARENT_INTERFACE)ExposedInterface;
    UCHAR Depth;
 
    UNREFERENCED_PARAMETER(InterfaceType);
    UNREFERENCED_PARAMETER(ExposedInterfaceSpecificData);
 
    if (!Child->HasProperty(ChildProperty::IsHub))
    {
        DPRINT1("Parent interface query on port %u, which is not a hub\n", Pdo->m_PortNumber);
        return STATUS_UNSUCCESSFUL;
    }
 
    Depth = Hub->m_Parent.HubDepth + 1;
 
    Parent->Header.Size = sizeof(*Parent);
    Parent->Header.Version = UCXHUB_PARENT_INTERFACE_VERSION;
    Parent->Header.Context = Pdo;
    Parent->Header.InterfaceReference = WdfDeviceInterfaceReferenceNoOp;
    Parent->Header.InterfaceDereference = WdfDeviceInterfaceDereferenceNoOp;
 
    Parent->HubDepth = Depth;
    Parent->ParentCanWake = Child->HasProperty(ChildProperty::RemoteWakeCapable);
 
    Parent->HubTopologyAddress = Hub->m_Parent.HubTopologyAddress;
    if (Depth == 1)
        Parent->HubTopologyAddress.RootHubPortNumber = Pdo->m_PortNumber;
    else if (Depth - 2 < (UCHAR)RTL_NUMBER_OF(Parent->HubTopologyAddress.HubPortNumber))
        Parent->HubTopologyAddress.HubPortNumber[Depth - 2] = Pdo->m_PortNumber;
 
    Parent->HubSpeed = Child->Speed();
    Parent->IsEnhancedSuperSpeed = HubPdoIsEnhancedSuperSpeed(Child);
    Parent->Hub = Child->m_UsbDevice;
 
    /* A hub on a root port hands down its own tunnel state; deeper hubs inherit it */
    Parent->TunnelState = (Depth == 1) ? Child->m_TunnelState : Hub->m_Parent.TunnelState;
 
    Parent->ParentLostStateDuringResume = HubPdoWasProgrammingLost;
    Parent->ParentResetDuringResume = HubPdoWasHubReset;
    Parent->ConnectorId = &Port->m_ConnectorId;
    Parent->QueryHubLinkName = HubPdoGetSymbolicLink;
 
    if (Port->HasProperty(PortProperty::IntegratedHub))
    {
        Parent->FirstCompanionPort = Port->m_FirstCompanionPort;
        Parent->LastCompanionPort = Port->m_LastCompanionPort;
 
        if (Hub->HasFlag(HubFlag::NoSelectiveSuspendIntegrated))
            Parent->ParentCanWake = FALSE;
    }
 
    Pdo->m_ChildHubFdo = Parent->ChildHubObject;
    DPRINT("Child hub %p on port %u at depth %u\n", Pdo->m_ChildHubFdo, Pdo->m_PortNumber, Depth);
    return STATUS_SUCCESS;
}

HubPdoEvtQueryRemove()

static NTSTATUS NTAPI HubPdoEvtQueryRemove ( _In_ WDFDEVICE  Device )

static

Definition at line 1332 of file childpdo.cpp.

{
    HubGetPdoContext(Device)->SetFlag(PdoFlag::QueryRemoved);
    return STATUS_SUCCESS;
}

HubPdoEvtQueryStop()

static NTSTATUS NTAPI HubPdoEvtQueryStop ( _In_ WDFDEVICE  Device )

static

Definition at line 1322 of file childpdo.cpp.

{
    HubGetPdoContext(Device)->SetFlag(PdoFlag::QueryStopped);
    return STATUS_SUCCESS;
}

HubPdoEvtReportedMissing()

static VOID NTAPI HubPdoEvtReportedMissing ( _In_ WDFDEVICE  Device )

static

Definition at line 1369 of file childpdo.cpp.

{
    HubPdo* Pdo = HubGetPdoContext(Device);
 
    DPRINT("Child PDO %p on port %u reported missing\n", Device, Pdo->m_PortNumber);
    Pdo->m_Child->Post(DsmEvent::PdoReportedMissing);
}

HubPdoEvtSelfManagedIoStart()

static NTSTATUS NTAPI HubPdoEvtSelfManagedIoStart ( _In_ WDFDEVICE  Device )

static

Definition at line 1469 of file childpdo.cpp.

{
    HubGetPdoContext(Device)->SetFlag(PdoFlag::InD0);
    return STATUS_SUCCESS;
}

HubPdoEvtSelfManagedIoSuspend()

static NTSTATUS NTAPI HubPdoEvtSelfManagedIoSuspend ( _In_ WDFDEVICE  Device )

static

Definition at line 1479 of file childpdo.cpp.

{
    HubPdo* Pdo = HubGetPdoContext(Device);
 
    Pdo->ClearFlag(PdoFlag::InD0);
    return STATUS_SUCCESS;
}

HubPdoFillHubInfo()

static VOID NTAPI HubPdoFillHubInfo ( _In_ HubPdo *  Pdo, _Inout_ HubParentInfo *  Info  )

static

Definition at line 2428 of file childpdo.cpp.

{
    HubChild* Child = Pdo->m_Child;
    HubFdo* Hub = Pdo->m_Hub;
    const HubParentInfo* Mine = &Hub->m_ParentInfo;
 
    Info->RootHubPdo = Mine->RootHubPdo;
    Info->DeviceDescriptor = Child->m_DeviceDescriptor;
    Info->U1ExitLatency = Child->m_U1ExitLatency;
    Info->U2ExitLatency = Child->m_U2ExitLatency;
    Info->SublinkSpeedAttr = Child->m_SublinkSpeedAttr;
    Info->SublinkSpeedAttrCount = Child->m_SublinkSpeedAttrCount;
    Info->TotalHubDepth = (UCHAR)Child->m_Port->m_Info.TotalHubDepth;
    Info->HostInitiatedU1ExitLatency = Child->m_HostU1ExitLatency;
    Info->HostInitiatedU2ExitLatency = Child->m_HostU2ExitLatency;
    Info->TotalTpPropagationDelay = Mine->TotalTpPropagationDelay +
                                    Hub->m_HubDescriptor.Usb30.wHubDelay +
                                    Child->m_TxTpDelay;
 
    if (Child->m_SlowestLinkU1)
    {
        Info->SlowestLinkU1ExitLatency = Child->m_Sel.U1Pel;
        Info->SlowestLinkU1Depth = Hub->m_Parent.HubDepth;
    }
    else
    {
        Info->SlowestLinkU1ExitLatency = Mine->SlowestLinkU1ExitLatency;
        Info->SlowestLinkU1Depth = Mine->SlowestLinkU1Depth;
    }
 
    if (Child->m_SlowestLinkU2)
    {
        Info->SlowestLinkU2ExitLatency = Child->m_Sel.U2Pel;
        Info->SlowestLinkU2Depth = Hub->m_Parent.HubDepth;
    }
    else
    {
        Info->SlowestLinkU2ExitLatency = Mine->SlowestLinkU2ExitLatency;
        Info->SlowestLinkU2Depth = Mine->SlowestLinkU2Depth;
    }
 
    if (Mine->Flags & HUB_PARENT_DISABLE_LPM)
        Info->Flags |= HUB_PARENT_DISABLE_LPM;
    if (Child->HasProperty(ChildProperty::HighSpeedCapable))
        Info->Flags |= HUB_PARENT_HIGH_SPEED_CAPABLE;
}

Referenced by HubPdoDispatchIoctl().

HubPdoForwardSelectLike()

static NTSTATUS NTAPI HubPdoForwardSelectLike ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp, _Inout_ PURB  Urb  )

static

Definition at line 2132 of file childpdo.cpp.

{
    if (Pdo->m_ControllerTarget == NULL)
    {
        DPRINT1("Port %u has no controller target for URB %p\n", Pdo->m_PortNumber, Urb);
        return HubPdoCompleteIrp(Irp, STATUS_NO_SUCH_DEVICE);
    }
 
    HubPdoStampUrb(Pdo, Urb);
    IoCopyCurrentIrpStackLocationToNext(Irp);
    IoSetCompletionRoutine(Irp, HubPdoSelectLikeComplete, Pdo->m_Child, TRUE, TRUE, TRUE);
    return IoCallDriver(Pdo->m_ControllerTarget, Irp);
}

Referenced by HubPdoRouteUrb().

HubPdoGetHubName()

static NTSTATUS NTAPI HubPdoGetHubName ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp  )

static

Definition at line 2218 of file childpdo.cpp.

{
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(Irp);
    PUSB_HUB_NAME HubName = (PUSB_HUB_NAME)Irp->AssociatedIrp.SystemBuffer;
    ULONG OutputLength = Stack->Parameters.DeviceIoControl.OutputBufferLength;
    UNICODE_STRING Link;
    PWCHAR Name;
    ULONG Chars;
    ULONG Index;
    ULONG NameBytes = 0;
 
    if (HubName == NULL)
    {
        DPRINT1("Port %u hub name request has no buffer\n", Pdo->m_PortNumber);
        return HubPdoCompleteIrp(Irp, STATUS_INVALID_PARAMETER);
    }
 
    if (OutputLength < sizeof(*HubName))
    {
        DPRINT1("Port %u hub name buffer of %lu bytes too small\n", Pdo->m_PortNumber, OutputLength);
        return HubPdoCompleteIrp(Irp, STATUS_BUFFER_TOO_SMALL);
    }
 
    if (!Pdo->m_Child->HasProperty(ChildProperty::IsHub))
    {
        HubName->ActualLength = sizeof(*HubName);
        HubName->HubName[0] = UNICODE_NULL;
        Irp->IoStatus.Information = sizeof(*HubName);
        return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
    }
 
    RtlZeroMemory(HubName, OutputLength);
    HubPdoGetSymbolicLink(Pdo, &Link);
 
    /* Drop the leading "\xxx\" of the symbolic link */
    Name = Link.Buffer;
    Chars = Link.Length / sizeof(WCHAR);
    if (Chars != 0 && Name[0] == L'\\')
    {
        for (Index = 1; Index < Chars && Name[Index] != L'\\'; Index++)
            ;
 
        if (Index < Chars)
        {
            Name += Index + 1;
            NameBytes = (Chars - Index - 1) * sizeof(WCHAR);
        }
    }
 
    if (NameBytes != 0 && OutputLength >= NameBytes + sizeof(*HubName))
        RtlCopyMemory(HubName->HubName, Name, NameBytes);
 
    HubName->ActualLength = NameBytes + sizeof(*HubName);
    Irp->IoStatus.Information = HubName->ActualLength;
    return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
}

Referenced by HubPdoDispatchIoctl().

HubPdoIndicateWake()

static VOID NTAPI HubPdoIndicateWake ( _In_ HubPdo *  Pdo )

static

Definition at line 1598 of file childpdo.cpp.

{
    NTSTATUS Status;
    KIRQL OldIrql;
 
    KeRaiseIrql(DISPATCH_LEVEL, &OldIrql);
    Status = WdfDeviceIndicateWakeStatus(Pdo->m_Device, STATUS_SUCCESS);
    KeLowerIrql(OldIrql);
 
    if (!NT_SUCCESS(Status))
        DPRINT1("Wake status not taken 0x%lx\n", Status);
}

Referenced by DeviceMachine::FinishWaitWake(), and HubPdoWakeNotificationComplete().

HubPdoIsEnhancedSuperSpeed()

static BOOLEAN NTAPI HubPdoIsEnhancedSuperSpeed ( _In_ HubChild *  Child )

static

Definition at line 866 of file childpdo.cpp.

{
    return (Child->m_Kind & DSM_KIND_SUPER_SPEED) && Child->m_SublinkSpeedAttrCount != 0;
}

Referenced by HubPdoEvtParentInterfaceQuery().

HubPdoLpmSettingChanged()

static NTSTATUS NTAPI HubPdoLpmSettingChanged ( _In_ LPCGUID  SettingGuid, _In_reads_bytes_(ValueLength) PVOID  Value, _In_ ULONG  ValueLength, _Inout_opt_ PVOID  Context  )

static

Definition at line 1742 of file childpdo.cpp.

{
    HubChild* Child = (HubChild*)Context;
    ULONG Policy = Child->m_LpmPolicy;
    ULONG Slot;
    ULONG Setting;
    ULONG Accept;
    ULONG Initiate;
 
    for (Slot = 0; Slot < HUB_PDO_LPM_SETTINGS; Slot++)
    {
        if (IsEqualGUID(*SettingGuid, HubLpmDeviceSettings[Slot]) ||
            IsEqualGUID(*SettingGuid, HubLpmHubSettings[Slot]))
        {
            break;
        }
    }
 
    if (Slot == HUB_PDO_LPM_SETTINGS)
        return STATUS_SUCCESS;
 
    if (Slot != HubLpmPolicy && ValueLength < sizeof(ULONG))
    {
        DPRINT1("LPM setting %lu of %p has only %lu bytes\n", Slot, Child, ValueLength);
        return STATUS_INVALID_PARAMETER;
    }
 
    Setting = *(PULONG)Value;
 
    switch (Slot)
    {
        case HubLpmPolicy:
            if (Setting > 3)
            {
                DPRINT1("LPM policy %lu of %p is out of range\n", Setting, Child);
                return STATUS_INVALID_PARAMETER;
            }
 
            if (Setting == 0)
            {
                Policy = 0;
                break;
            }
 
            Policy |= HUB_LPM_POLICY_LINK_BITS;
            Policy &= ~(HUB_LPM_POLICY_CONSERVATIVE | HUB_LPM_POLICY_AGGRESSIVE);
            if (Setting == 1)
                Policy |= HUB_LPM_POLICY_CONSERVATIVE;
            else if (Setting == 3)
                Policy |= HUB_LPM_POLICY_AGGRESSIVE;
            break;
 
        case HubLpmU1Enable:
            if (Setting != 0)
                Policy |= HUB_LPM_POLICY_U1_ENABLED;
            else
                Policy &= ~HUB_LPM_POLICY_U1_ENABLED;
            break;
 
        case HubLpmU2Enable:
            if (Setting != 0)
                Policy |= HUB_LPM_POLICY_U2_ENABLED;
            else
                Policy &= ~HUB_LPM_POLICY_U2_ENABLED;
            break;
 
        default:
            Accept = (Slot == HubLpmU1Timeout) ? HUB_LPM_POLICY_U1_ACCEPT : HUB_LPM_POLICY_U2_ACCEPT;
            Initiate = (Slot == HubLpmU1Timeout) ? HUB_LPM_POLICY_U1_INITIATE : HUB_LPM_POLICY_U2_INITIATE;
 
            if (Setting == 0)
                Policy |= Accept | Initiate;
            else if (Setting == 1)
                Policy = (Policy | Accept) & ~Initiate;
            else if (Setting == 2)
                Policy &= ~(Accept | Initiate);
            break;
    }
 
    if (Policy != Child->m_LpmPolicy)
    {
        DPRINT("LPM policy of %p now 0x%lx\n", Child, Policy);
        Child->m_LpmPolicy = Policy;
        Child->Post(DsmEvent::LpmSettingChanged);
    }
 
    return STATUS_SUCCESS;
}

HubPdoMsFeatureDescriptor()

static NTSTATUS NTAPI HubPdoMsFeatureDescriptor ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp, _Inout_ PURB  Urb  )

static

Definition at line 2062 of file childpdo.cpp.

{
    struct _URB_OS_FEATURE_DESCRIPTOR_REQUEST* Request = &Urb->UrbOSFeatureDescriptorRequest;
    HubChild* Child = Pdo->m_Child;
    USHORT BcdUsb = Child->m_DeviceDescriptor.bcdUSB;
    const HubMsOs20SetHeader* Set;
    PVOID Buffer;
    ULONG Size;
 
    if (Request->MS_FeatureDescriptorIndex == HUB_MSOS20_SET_INDEX)
    {
        Set = (const HubMsOs20SetHeader*)Child->m_MsOs20Set;
        if (Set == NULL)
        {
            DPRINT1("Port %u has no MS OS 2.0 descriptor set\n", Pdo->m_PortNumber);
            return HubPdoCompleteIrp(Irp, STATUS_NOT_SUPPORTED);
        }
 
        Buffer = HubPdoUrbBuffer(Request->TransferBuffer, Request->TransferBufferMDL);
        if (Buffer == NULL)
        {
            DPRINT1("Port %u MS OS 2.0 URB %p has no buffer\n", Pdo->m_PortNumber, Urb);
            return HubPdoCompleteIrp(Irp, STATUS_NOT_SUPPORTED);
        }
 
        Size = min((ULONG)Set->wTotalLength, Request->TransferBufferLength);
        RtlCopyMemory(Buffer, Set, Size);
        Request->TransferBufferLength = Size;
        return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
    }
 
    if (((BcdUsb >= 0x0200 || BcdUsb < 0x0100) && !Child->HasProperty(ChildProperty::MsOsNotSupported)) ||
        Child->HasHack(ChildHack::AlwaysQueryMsOs))
    {
        /* The device's own vendor code goes into the request */
        Urb->UrbControlVendorClassRequest.Request = Child->m_MsOsVendorCode;
        HubPdoStampUrb(Pdo, Urb);
        return HubPdoToController(Pdo, Irp);
    }
 
    DPRINT1("Port %u device does not support MS OS descriptors\n", Pdo->m_PortNumber);
    return HubPdoCompleteIrp(Irp, STATUS_NOT_SUPPORTED);
}

Referenced by HubPdoRouteUrb().

HubPdoPassDown()

static NTSTATUS NTAPI HubPdoPassDown ( _In_ WDFDEVICE  Device, _Inout_ PIRP  Irp  )

static

Definition at line 312 of file childpdo.cpp.

{
    IoSkipCurrentIrpStackLocation(Irp);
    return WdfDeviceWdmDispatchPreprocessedIrp(Device, Irp);
}

Referenced by HubPdoPreprocessIoctl(), HubPdoPreprocessPnp(), HubPdoPreprocessSetPower(), and HubPdoQueryInterface().

HubPdoPostAndWait()

HubPdoPostAndWait	(	Pdo->	m_Child,
		DsmEvent::PdoInstallMsOsExt	,
		"PdoInstallMsOsExt"
	)

HubPdoPowerIrpComplete()

static NTSTATUS NTAPI HubPdoPowerIrpComplete ( _In_ PDEVICE_OBJECT  DeviceObject, _In_ PIRP  Irp, _In_reads_opt_(_Inexpressible_("varies")) PVOID  Context  )

static

Definition at line 1101 of file childpdo.cpp.

{
    HubPdo* Pdo = (HubPdo*)Context;
    WDF_WORKITEM_CONFIG Config;
    WDF_OBJECT_ATTRIBUTES Attributes;
    WDFWORKITEM WorkItem;
    NTSTATUS Status;
 
    UNREFERENCED_PARAMETER(DeviceObject);
 
    if (Irp->PendingReturned)
        IoMarkIrpPending(Irp);
 
    WDF_WORKITEM_CONFIG_INIT(&Config, HubPdoEvtCompletePowerIrp);
    Config.AutomaticSerialization = FALSE;
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&Attributes, HubPdoIrpWork);
    Attributes.ParentObject = Pdo->m_Device;
 
    Status = WdfWorkItemCreate(&Config, &Attributes, &WorkItem);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("Port %u power IRP %p completes inline, work item failed 0x%lx\n",
                Pdo->m_PortNumber, Irp, Status);
        return STATUS_CONTINUE_COMPLETION;
    }
 
    HubGetPdoIrpWork(WorkItem)->Irp = Irp;
    WdfWorkItemEnqueue(WorkItem);
    return STATUS_MORE_PROCESSING_REQUIRED;
}

Referenced by HubPdoPreprocessSetPower().

HubPdoPreprocessInternalIoctl()

static NTSTATUS NTAPI HubPdoPreprocessInternalIoctl ( _In_ WDFDEVICE  Device, _Inout_ PIRP  Irp  )

static

Definition at line 2697 of file childpdo.cpp.

{
    HubPdo* Pdo = HubGetPdoContext(Device);
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(Irp);
    ULONG Code = Stack->Parameters.DeviceIoControl.IoControlCode;
    PURB Urb = NULL;
    BOOLEAN Exempt = FALSE;
 
    switch (Code)
    {
        case IOCTL_INTERNAL_USB_SUBMIT_URB:
            Urb = (PURB)Stack->Parameters.Others.Argument1;
            Exempt = Urb->UrbHeader.Function == URB_FUNCTION_OPEN_STATIC_STREAMS ||
                     Urb->UrbHeader.Function == URB_FUNCTION_CLOSE_STATIC_STREAMS;
            break;
 
        case IOCTL_INTERNAL_USB_UNREGISTER_COMPOSITE_DEVICE:
        case IOCTL_UCXHUB_QUERY_USB_CAPABILITY:
            Exempt = TRUE;
            break;
 
        case IOCTL_UCXHUB_RESET_PORT_ASYNC:
            Exempt = Pdo->HasFlag(PdoFlag::InBootPath);
            break;
 
        case IOCTL_INTERNAL_USB_FAIL_GET_STATUS_FROM_DEVICE:
            DPRINT("Port %u client says GET_STATUS is unsupported\n", Pdo->m_PortNumber);
            Pdo->SetFlag(PdoFlag::FailGetStatus);
            return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
 
        default:
            break;
    }
 
    /* A failed URB carries an invalid parameter status, like the USB 2.0 hub */
    if (Pdo->m_FailRequests && !Exempt)
    {
        DPRINT1("Port %u IRP %p IOCTL 0x%lx failed, the device is not present\n", Pdo->m_PortNumber, Irp, Code);
 
        if (Urb != NULL)
            Urb->UrbHeader.Status = USBD_STATUS_INVALID_PARAMETER;
 
        return HubPdoCompleteIrp(Irp, STATUS_NO_SUCH_DEVICE);
    }
 
    if (Urb != NULL)
        return HubPdoRouteUrb(Pdo, Irp, Urb);
 
    return HubPdoDispatchIoctl(Pdo, Irp);
}

HubPdoPreprocessIoctl()

static NTSTATUS NTAPI HubPdoPreprocessIoctl ( _In_ WDFDEVICE  Device, _Inout_ PIRP  Irp  )

static

Definition at line 2781 of file childpdo.cpp.

{
    HubPdo* Pdo = HubGetPdoContext(Device);
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(Irp);
 
    switch (Stack->Parameters.DeviceIoControl.IoControlCode)
    {
        case HUB_IOCTL_GET_TRANSPORT_CHARACTERISTICS:
        case HUB_IOCTL_NOTIFY_TRANSPORT_CHANGE:
        case HUB_IOCTL_UNREGISTER_TRANSPORT_CHANGE:
        case HUB_IOCTL_START_TIME_SYNC:
        case HUB_IOCTL_GET_TIME_SYNC:
        case HUB_IOCTL_STOP_TIME_SYNC:
            return HubPdoToController(Pdo, Irp);
 
        case HUB_IOCTL_REGISTER_TRANSPORT_CHANGE:
            return HubPdoStampAndForward(Pdo, Irp, HUB_TRANSPORT_REGISTRATION_SIZE);
 
        case HUB_IOCTL_GET_DEVICE_CHARACTERISTICS:
            return HubPdoStampAndForward(Pdo, Irp, HUB_DEVICE_CHARACTERISTICS_SIZE);
 
        default:
            return HubPdoPassDown(Device, Irp);
    }
}

HubPdoPreprocessPnp()

static NTSTATUS NTAPI HubPdoPreprocessPnp ( _In_ WDFDEVICE  Device, _Inout_ PIRP  Irp  )

static

Definition at line 1013 of file childpdo.cpp.

{
    HubPdo* Pdo = HubGetPdoContext(Device);
    HubChild* Child = Pdo->m_Child;
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(Irp);
    NTSTATUS EntryStatus = Irp->IoStatus.Status;
 
    switch (Stack->MinorFunction)
    {
        case IRP_MN_QUERY_INTERFACE:
            return HubPdoQueryInterface(Pdo, Irp);
 
        case IRP_MN_QUERY_DEVICE_TEXT:
            return HubIdQueryDeviceText(Child, Irp);
 
        case IRP_MN_QUERY_ID:
            HubPdoPreStartOnQueryId(Pdo, Irp);
            return HubPdoPassDown(Device, Irp);
 
        case IRP_MN_REMOVE_DEVICE:
            Pdo->m_ChildHubFdo = NULL;
            return HubPdoPassDown(Device, Irp);
 
        /* KMDF leaves STATUS_NOT_SUPPORTED here; the EHCI stack answered success */
        case IRP_MN_DEVICE_ENUMERATED:
            HubPdoDispatchAndWait(Device, Irp);
 
            HubPdoQueryAcpiD3Cold(Pdo);
            if (Child->m_Billboard != NULL)
                HubPdoPublishBillboard(Pdo);
            if (Child->HasProperty(ChildProperty::DualRole))
                HubPdoPublishDualRole(Pdo);
            HubPdoPublishTunnelState(Pdo);
 
            return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
 
        /* Kept synchronous; the EHCI stack never pended these */
        case IRP_MN_START_DEVICE:
        case IRP_MN_SURPRISE_REMOVAL:
            HubPdoDispatchAndWait(Device, Irp);
            return HubPdoCompleteAsIs(Irp);
 
        /* KMDF writes success; the status from above is returned instead */
        case IRP_MN_QUERY_RESOURCE_REQUIREMENTS:
            HubPdoDispatchAndWait(Device, Irp);
            return HubPdoCompleteIrp(Irp, EntryStatus);
 
        case IRP_MN_QUERY_PNP_DEVICE_STATE:
            HubPdoDispatchAndWait(Device, Irp);
 
            if (Irp->IoStatus.Information == 0)
                return HubPdoCompleteIrp(Irp, EntryStatus);
 
            if (Child->m_EnumMessageId != 0)
            {
                DPRINT1("Port %u reports enumeration problem %lu\n", Pdo->m_PortNumber, Child->m_EnumMessageId);
                HubWriteEnumerationFailureCode(Child);
                HubReportPnpProblem(Device, Child->m_EnumMessageId);
            }
 
            return HubPdoCompleteAsIs(Irp);
 
        default:
            return HubPdoPassDown(Device, Irp);
    }
}

HubPdoPreprocessSetPower()

static NTSTATUS NTAPI HubPdoPreprocessSetPower ( _In_ WDFDEVICE  Device, _Inout_ PIRP  Irp  )

static

Definition at line 1139 of file childpdo.cpp.

{
    HubPdo* Pdo = HubGetPdoContext(Device);
    HubChild* Child = Pdo->m_Child;
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(Irp);
    DEVICE_POWER_STATE Target;
    NTSTATUS Status;
 
    if (Stack->Parameters.Power.Type != DevicePowerState)
        return HubPdoPassDown(Device, Irp);
 
    Target = Stack->Parameters.Power.State.DeviceState;
    DPRINT("Port %u device power IRP to D%d\n", Pdo->m_PortNumber, (int)Target - 1);
 
    if (Target == PowerDeviceD3 && Child->m_PowerState == PowerDeviceD2)
    {
        /* Fails when no wait wake IRP is pending, which is fine */
        Status = WdfDeviceIndicateWakeStatus(Device, STATUS_POWER_STATE_INVALID);
        if (!NT_SUCCESS(Status))
            DPRINT1("Port %u D2 to D3 wake status not taken 0x%lx\n", Pdo->m_PortNumber, Status);
 
        Pdo->m_Idle.Post(IdleEvent::PoweringDown, NULL);
    }
 
    Child->m_PowerState = Target;
 
    /* The completion may finish the IRP later on a work item, so it is always pending */
    IoMarkIrpPending(Irp);
    IoCopyCurrentIrpStackLocationToNext(Irp);
    IoSetCompletionRoutine(Irp, HubPdoPowerIrpComplete, Pdo, TRUE, TRUE, TRUE);
    WdfDeviceWdmDispatchPreprocessedIrp(Device, Irp);
    return STATUS_PENDING;
}

HubPdoPreStart()

HubPdoPreStart

(

Pdo->

m_Child

)

HubPdoQueryCapability()

static NTSTATUS NTAPI HubPdoQueryCapability ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp, _Inout_ PUCXHUB_QUERY_CAPABILITY  Query  )

static

Definition at line 2480 of file childpdo.cpp.

{
    ULONG Kind = Pdo->m_Child->m_Kind;
    const GUID* Type = &Query->CapabilityType;
    BOOLEAN Supported;
 
    Query->ResultLength = 0;
 
    DPRINT("Port %u capability query {%08lx-...}\n", Pdo->m_PortNumber, Type->Data1);
 
    if (IsEqualGUID(*Type, GUID_USB_CAPABILITY_FUNCTION_SUSPEND))
        return HubPdoCompleteIrp(Irp, (Kind & DSM_KIND_PORT20) ? STATUS_NOT_SUPPORTED : STATUS_SUCCESS);
 
    if (IsEqualGUID(*Type, GUID_USB_CAPABILITY_STATIC_STREAMS))
    {
        if (Kind & DSM_KIND_PORT20)
            return HubPdoCompleteIrp(Irp, STATUS_NOT_SUPPORTED);
 
        return HubPdoToController(Pdo, Irp);
    }
 
    /* Answered here, without output */
    if (IsEqualGUID(*Type, GUID_USB_CAPABILITY_SSP_ISOCH_PIPE_FLAGS))
        return HubPdoCompleteIrp(Irp, STATUS_SUCCESS);
 
    if (IsEqualGUID(*Type, GUID_USB_CAPABILITY_DEVICE_CONNECTION_SUPER_SPEED_COMPATIBLE))
        Supported = (Kind & DSM_KIND_SUPER_SPEED) != 0;
    else if (IsEqualGUID(*Type, GUID_USB_CAPABILITY_DEVICE_CONNECTION_HIGH_SPEED_COMPATIBLE))
        Supported = (Kind & (DSM_KIND_SUPER_SPEED | DSM_KIND_HIGH_SPEED)) != 0;
    else if (IsEqualGUID(*Type, HubCapFullSpeedCompatible))
        Supported = (Kind & (DSM_KIND_SUPER_SPEED | DSM_KIND_HIGH_SPEED | DSM_KIND_FULL_SPEED)) != 0;
    else if (IsEqualGUID(*Type, HubCapLowSpeedCompatible))
        Supported = TRUE;
    else
        return HubPdoToController(Pdo, Irp);
 
    return HubPdoCompleteIrp(Irp, Supported ? STATUS_SUCCESS : STATUS_NOT_SUPPORTED);
}

Referenced by HubPdoDispatchIoctl().

HubPdoQueryInterface()

static NTSTATUS NTAPI HubPdoQueryInterface ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp  )

static

Definition at line 769 of file childpdo.cpp.

{
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(Irp);
    const GUID* Type = Stack->Parameters.QueryInterface.InterfaceType;
    PUSBD_CLIENT_INTERFACE Client;
    HubChild* Child = Pdo->m_Child;
 
    /* Placeholders answer nothing; the PDO's own D3cold probe is left to ACPI */
    if (!Child->HasState(ChildState::WorkingDevice) ||
        Stack->Parameters.QueryInterface.InterfaceSpecificData == Pdo)
    {
        DPRINT("Interface query on port %u left alone\n", Pdo->m_PortNumber);
        return HubPdoCompleteAsIs(Irp);
    }
 
    if (IsEqualGUID(*Type, USB_BUS_INTERFACE_USBDI_GUID))
    {
        Stack->Parameters.QueryInterface.InterfaceSpecificData = Child->m_UsbDevice;
        return HubPdoToController(Pdo, Irp);
    }
 
    /* The contract is recorded for every 602 or later client, not only exact matches */
    if (IsEqualGUID(*Type, GUID_USBD_CLIENT_INTERFACE))
    {
        Stack->Parameters.QueryInterface.InterfaceSpecificData = Child->m_UsbDevice;
        Client = (PUSBD_CLIENT_INTERFACE)Stack->Parameters.QueryInterface.Interface;
 
        if (Stack->Parameters.QueryInterface.Size >= sizeof(*Client) ||
            Stack->Parameters.QueryInterface.Version >= USBD_CLIENT_INTERFACE_VERSION)
        {
            Pdo->m_ClientContractVersion = Client->ClientContractVersion;
        }
 
        return HubPdoToController(Pdo, Irp);
    }
 
    if (IsEqualGUID(*Type, GUID_UCXHUB_STACK_INTERFACE))
        return HubPdoToController(Pdo, Irp);
 
    if (IsEqualGUID(*Type, GUID_D3COLD_SUPPORT_INTERFACE))
        return HubPdoAnswerD3Cold(Pdo, Irp);
 
    return HubPdoPassDown(Pdo->m_Device, Irp);
}

Referenced by HubPdoPreprocessPnp().

HubPdoQueueAndWait()

static NTSTATUS NTAPI HubPdoQueueAndWait ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp, _In_ WDFQUEUE  Queue  )

static

Definition at line 1902 of file childpdo.cpp.

{
    KEVENT Event;
    NTSTATUS Status;
 
    KeInitializeEvent(&Event, NotificationEvent, FALSE);
    IoCopyCurrentIrpStackLocationToNext(Irp);
    IoSetCompletionRoutine(Irp, HubPdoSyncComplete, &Event, TRUE, TRUE, TRUE);
 
    /* On failure KMDF completes the IRP, so the completion routine still runs */
    Status = WdfDeviceWdmDispatchIrpToIoQueue(Pdo->m_Device, Irp, Queue, WDF_DISPATCH_IRP_TO_IO_QUEUE_PREPROCESSED_IRP);
    if (!NT_SUCCESS(Status))
        DPRINT1("Dispatch to queue failed 0x%lx\n", Status);
 
    KeWaitForSingleObject(&Event, Executive, KernelMode, FALSE, NULL);
 
    Status = Irp->IoStatus.Status;
    IoCompleteRequest(Irp, IO_NO_INCREMENT);
    return Status;
}

Referenced by HubPdoDispatchIoctl(), and HubPdoRouteUrb().

HubPdoQueueAsync()

static NTSTATUS NTAPI HubPdoQueueAsync ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp  )

static

Definition at line 1929 of file childpdo.cpp.

{
    IoCopyCurrentIrpStackLocationToNext(Irp);
    return WdfDeviceWdmDispatchIrpToIoQueue(Pdo->m_Device, Irp, Pdo->m_Queue, WDF_DISPATCH_IRP_TO_IO_QUEUE_PREPROCESSED_IRP);
}

Referenced by HubPdoDispatchIoctl(), and HubPdoRouteUrb().

HubPdoRecordFailure()

static NTSTATUS NTAPI HubPdoRecordFailure ( _In_ HubPdo *  Pdo, _In_opt_ HubStartFailHeader *  Data  )

static

Definition at line 2281 of file childpdo.cpp.

{
    HubStartFailHeader* Copy;
    ULONG Length;
 
    if (Pdo->m_StartFailData != NULL || Data == NULL)
    {
        DPRINT1("Port %u start failure not recorded, data %p, already %p\n",
                Pdo->m_PortNumber, Data, Pdo->m_StartFailData);
        return STATUS_INVALID_PARAMETER;
    }
 
    if (Data->LengthInBytes > HUB_START_FAIL_MAX)
        DPRINT1("Port %u start failure data of %lu bytes cut down\n", Pdo->m_PortNumber, Data->LengthInBytes);
 
    Length = min(Data->LengthInBytes, (ULONG)HUB_START_FAIL_MAX);
    if (Length < sizeof(*Data))
    {
        DPRINT1("Port %u start failure data of %lu bytes too small\n", Pdo->m_PortNumber, Length);
        return STATUS_BUFFER_TOO_SMALL;
    }
 
    Copy = (HubStartFailHeader*)ExAllocatePoolWithTag(NonPagedPool, Length, HUB_TAG_DEVICE);
    if (Copy == NULL)
    {
        DPRINT1("No memory for %lu bytes of port %u start failure data\n", Length, Pdo->m_PortNumber);
        return STATUS_INSUFFICIENT_RESOURCES;
    }
 
    RtlCopyMemory(Copy, Data, Length);
    Pdo->m_StartFailData = Copy;
    Pdo->m_Child->m_Port->m_ConnectionStatus = (USB_CONNECTION_STATUS)Copy->ConnectStatus;
    return STATUS_SUCCESS;
}

Referenced by HubPdoDispatchIoctl().

HubPdoRegisterLpmSettings()

HubPdoRegisterLpmSettings

(

Pdo

)

HubPdoResolveSystemWake()

HubPdoResolveSystemWake

(

)

HubPdoRouteUrb()

static NTSTATUS NTAPI HubPdoRouteUrb ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp, _Inout_ PURB  Urb  )

static

Definition at line 2153 of file childpdo.cpp.

{
    NTSTATUS Status;
 
    switch (Urb->UrbHeader.Function)
    {
        case URB_FUNCTION_BULK_OR_INTERRUPT_TRANSFER:
        case URB_FUNCTION_ISOCH_TRANSFER:
        case HUB_URB_FUNCTION_FAST_PATH_1:
        case HUB_URB_FUNCTION_FAST_PATH_2:
            HubPdoStampUrb(Pdo, Urb);
            return HubPdoToController(Pdo, Irp);
 
        case URB_FUNCTION_GET_DESCRIPTOR_FROM_DEVICE:
            return HubPdoCachedDescriptor(Pdo, Irp, Urb);
 
        case URB_FUNCTION_SELECT_CONFIGURATION:
        case URB_FUNCTION_SELECT_INTERFACE:
        case URB_FUNCTION_SYNC_RESET_PIPE_AND_CLEAR_STALL:
        case URB_FUNCTION_SYNC_RESET_PIPE:
        case URB_FUNCTION_SYNC_CLEAR_STALL:
            Status = HubPdoValidateUrb(Urb);
            if (!NT_SUCCESS(Status))
                return HubPdoCompleteIrp(Irp, Status);
 
            if (Pdo->m_Child->HasProperty(ChildProperty::IsHub))
                return HubPdoQueueAsync(Pdo, Irp);
 
            return HubPdoQueueAndWait(Pdo, Irp, Pdo->m_Queue);
 
        case HUB_URB_FUNCTION_SELECT_LIKE:
            return HubPdoForwardSelectLike(Pdo, Irp, Urb);
 
        case URB_FUNCTION_GET_MS_FEATURE_DESCRIPTOR:
            return HubPdoMsFeatureDescriptor(Pdo, Irp, Urb);
 
        case URB_FUNCTION_OPEN_STATIC_STREAMS:
        case URB_FUNCTION_CLOSE_STATIC_STREAMS:
            HubPdoStampUrb(Pdo, Urb);
            return HubPdoQueueAndWait(Pdo, Irp, Pdo->m_Queue);
 
        case URB_FUNCTION_GET_STATUS_FROM_DEVICE:
            if (Pdo->HasFlag(PdoFlag::FailGetStatus))
            {
                DPRINT1("Port %u GET_STATUS failed, the client said it is unsupported\n", Pdo->m_PortNumber);
                return HubPdoCompleteIrp(Irp, STATUS_NOT_SUPPORTED);
            }
 
            HubPdoStampUrb(Pdo, Urb);
            return HubPdoToController(Pdo, Irp);
 
        /* UCX validates everything else */
        default:
            HubPdoStampUrb(Pdo, Urb);
            return HubPdoToController(Pdo, Irp);
    }
}

Referenced by HubPdoPreprocessInternalIoctl().

HubPdoSelectLikeComplete()

static NTSTATUS NTAPI HubPdoSelectLikeComplete ( _In_ PDEVICE_OBJECT  DeviceObject, _In_ PIRP  Irp, _In_reads_opt_(_Inexpressible_("varies")) PVOID  Context  )

static

Definition at line 2112 of file childpdo.cpp.

{
    UNREFERENCED_PARAMETER(DeviceObject);
 
    if (Irp->PendingReturned)
        IoMarkIrpPending(Irp);
 
    if (NT_SUCCESS(Irp->IoStatus.Status))
        ((HubChild*)Context)->SetState(ChildState::ConfigurationValid);
 
    return STATUS_CONTINUE_COMPLETION;
}

Referenced by HubPdoForwardSelectLike().

HubPdoSendWakeNotification()

static NTSTATUS NTAPI HubPdoSendWakeNotification ( _In_ HubPdo *  Pdo )

static

Definition at line 1636 of file childpdo.cpp.

{
    WDF_REQUEST_REUSE_PARAMS Reuse;
    IO_STACK_LOCATION Stack;
    WDFREQUEST Request = Pdo->m_WakeRequest;
    NTSTATUS Status;
 
    WDF_REQUEST_REUSE_PARAMS_INIT(&Reuse, WDF_REQUEST_REUSE_NO_FLAGS, STATUS_SUCCESS);
    Status = WdfRequestReuse(Request, &Reuse);
    if (!NT_SUCCESS(Status))
        DPRINT1("Wake request reuse failed 0x%lx\n", Status);
 
    RtlZeroMemory(&Pdo->m_WakeBlock, sizeof(Pdo->m_WakeBlock));
    Pdo->m_WakeBlock.Size = sizeof(Pdo->m_WakeBlock);
    KeClearEvent(&Pdo->m_WakeDone);
 
    RtlZeroMemory(&Stack, sizeof(Stack));
    Stack.MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL;
    Stack.Parameters.Others.Argument1 = &Pdo->m_WakeBlock;
    Stack.Parameters.Others.Argument2 = Pdo->m_Child->m_UsbDevice;
    Stack.Parameters.DeviceIoControl.IoControlCode = IOCTL_INTERNAL_USB_REQUEST_REMOTE_WAKE_NOTIFICATION;
 
    WdfRequestWdmFormatUsingStackLocation(Request, &Stack);
    WdfRequestSetCompletionRoutine(Request, HubPdoWakeNotificationComplete, Pdo);
 
    if (!WdfRequestSend(Request, Pdo->m_Hub->m_RootHubTarget, WDF_NO_SEND_OPTIONS))
    {
        Status = WdfRequestGetStatus(Request);
        DPRINT1("Port %u wake notification not sent 0x%lx\n", Pdo->m_PortNumber, Status);
        return Status;
    }
 
    return STATUS_SUCCESS;
}

Referenced by HubPdoEvtEnableWakeAtBus().

HubPdoSetCallbacks()

HubPdoSetCallbacks

(

Init

)

HubPdoSetPnpCapabilities()

HubPdoSetPnpCapabilities

(

Pdo

)

HubPdoSignalCompletion()

static NTSTATUS NTAPI HubPdoSignalCompletion ( _In_ PDEVICE_OBJECT  DeviceObject, _In_ PIRP  Irp, _In_reads_opt_(_Inexpressible_("varies")) PVOID  Context  )

static

Definition at line 341 of file childpdo.cpp.

{
    UNREFERENCED_PARAMETER(DeviceObject);
    UNREFERENCED_PARAMETER(Irp);
 
    KeSetEvent((PKEVENT)Context, IO_NO_INCREMENT, FALSE);
    return STATUS_MORE_PROCESSING_REQUIRED;
}

HubPdoStampAndForward()

static NTSTATUS NTAPI HubPdoStampAndForward ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp, _In_ ULONG  Size  )

static

Definition at line 2754 of file childpdo.cpp.

{
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(Irp);
    PUCHAR Buffer = (PUCHAR)Irp->AssociatedIrp.SystemBuffer;
    UCXUSBDEVICE UsbDevice = Pdo->m_Child->m_UsbDevice;
 
    if (Stack->Parameters.DeviceIoControl.InputBufferLength != Size ||
        Stack->Parameters.DeviceIoControl.OutputBufferLength != Size ||
        Buffer == NULL)
    {
        DPRINT1("Port %u IOCTL 0x%lx buffers %lu/%lu, expected %lu\n",
                Pdo->m_PortNumber, Stack->Parameters.DeviceIoControl.IoControlCode,
                Stack->Parameters.DeviceIoControl.InputBufferLength,
                Stack->Parameters.DeviceIoControl.OutputBufferLength, Size);
        return HubPdoCompleteIrp(Irp, STATUS_INVALID_PARAMETER);
    }
 
    RtlCopyMemory(Buffer + HUB_STAMPED_HANDLE_OFFSET, &UsbDevice, sizeof(UsbDevice));
    return HubPdoToController(Pdo, Irp);
}

Referenced by HubPdoPreprocessIoctl().

HubPdoStampUrb()

static VOID NTAPI HubPdoStampUrb ( _In_ HubPdo *  Pdo, _Inout_ PURB  Urb  )

static

Definition at line 1940 of file childpdo.cpp.

{
    Urb->UrbHeader.UsbdDeviceHandle = Pdo->m_Child->m_UsbDevice;
}

Referenced by HubPdoCachedDescriptor(), HubPdoForwardSelectLike(), HubPdoMsFeatureDescriptor(), and HubPdoRouteUrb().

HubPdoSyncComplete()

static NTSTATUS NTAPI HubPdoSyncComplete ( _In_ PDEVICE_OBJECT  DeviceObject, _In_ PIRP  Irp, _In_reads_opt_(_Inexpressible_("varies")) PVOID  Context  )

static

Definition at line 1876 of file childpdo.cpp.

{
    PIO_STACK_LOCATION Stack = IoGetCurrentIrpStackLocation(Irp);
    NTSTATUS Status = Irp->IoStatus.Status;
 
    UNREFERENCED_PARAMETER(DeviceObject);
 
    if (!NT_SUCCESS(Status) &&
        Stack->Parameters.DeviceIoControl.IoControlCode == IOCTL_INTERNAL_USB_SUBMIT_URB)
    {
        PURB Urb = (PURB)Stack->Parameters.Others.Argument1;
        if (Urb->UrbHeader.Status == USBD_STATUS_SUCCESS)
            Urb->UrbHeader.Status = HubNtStatusToUsbd(Status);
    }
 
    KeSetEvent((PKEVENT)Context, IO_NO_INCREMENT, FALSE);
    return STATUS_MORE_PROCESSING_REQUIRED;
}

Referenced by HubPdoQueueAndWait().

HubPdoToController()

static NTSTATUS NTAPI HubPdoToController ( _In_ HubPdo *  Pdo, _Inout_ PIRP  Irp  )

static

Definition at line 324 of file childpdo.cpp.

{
    if (Pdo->m_ControllerTarget == NULL)
    {
        DPRINT1("Port %u has no controller target for IRP %p\n", Pdo->m_PortNumber, Irp);
        return HubPdoCompleteIrp(Irp, STATUS_NO_SUCH_DEVICE);
    }
 
    IoSkipCurrentIrpStackLocation(Irp);
    return IoCallDriver(Pdo->m_ControllerTarget, Irp);
}

Referenced by HubPdoCachedDescriptor(), HubPdoDispatchIoctl(), HubPdoMsFeatureDescriptor(), HubPdoPreprocessIoctl(), HubPdoQueryCapability(), HubPdoQueryInterface(), HubPdoRouteUrb(), and HubPdoStampAndForward().

HubPdoTopologyAddress()

static NTSTATUS NTAPI HubPdoTopologyAddress ( _In_ HubPdo *  Pdo, _Out_opt_ PUSB_TOPOLOGY_ADDRESS  Address  )

static

Definition at line 2401 of file childpdo.cpp.

{
    HubFdo* Hub = Pdo->m_Hub;
    UCHAR Depth = Hub->m_Parent.HubDepth;
 
    if (Address == NULL)
    {
        DPRINT1("Port %u topology address request has no buffer\n", Pdo->m_PortNumber);
        return STATUS_INVALID_PARAMETER;
    }
 
    *Address = Hub->m_Parent.HubTopologyAddress;
 
    if (Depth == 0)
        Address->RootHubPortNumber = Pdo->m_PortNumber;
    else if (Depth - 1 < (UCHAR)RTL_NUMBER_OF(Address->HubPortNumber))
        Address->HubPortNumber[Depth - 1] = Pdo->m_PortNumber;
 
    return STATUS_SUCCESS;
}

Referenced by HubPdoDispatchIoctl().

HubPdoUrbBuffer()

static PVOID NTAPI HubPdoUrbBuffer ( _In_ PVOID  Pointer, _In_opt_ PMDL  Mdl  )

static

Definition at line 1986 of file childpdo.cpp.

{
    if (Mdl != NULL)
        return MmGetSystemAddressForMdlSafe(Mdl, NormalPagePriority);
 
    return Pointer;
}

Referenced by HubPdoCachedDescriptor(), and HubPdoMsFeatureDescriptor().

HubPdoValidateUrb()

static NTSTATUS NTAPI HubPdoValidateUrb ( _Inout_ PURB  Urb )

static

Definition at line 1951 of file childpdo.cpp.

{
    USHORT Function = Urb->UrbHeader.Function;
 
    if (Urb->UrbHeader.Length < sizeof(struct _URB_HEADER))
        DPRINT1("URB %p header length %u too small\n", Urb, Urb->UrbHeader.Length);
 
    Urb->UrbHeader.Status = USBD_STATUS_SUCCESS;
    Urb->UrbHeader.UsbdFlags = 0;
 
    if (Function > HUB_URB_FUNCTION_LAST)
    {
        DPRINT1("URB %p has invalid function 0x%x\n", Urb, Function);
        Urb->UrbHeader.Status = USBD_STATUS_INVALID_URB_FUNCTION;
        return STATUS_INVALID_PARAMETER;
    }
 
    if ((Function == URB_FUNCTION_SYNC_RESET_PIPE_AND_CLEAR_STALL ||
         Function == URB_FUNCTION_SYNC_RESET_PIPE ||
         Function == URB_FUNCTION_SYNC_CLEAR_STALL) &&
        Urb->UrbHeader.Length != sizeof(struct _URB_PIPE_REQUEST))
    {
        DPRINT1("Pipe URB %p length %u, expected %lu\n",
                Urb, Urb->UrbHeader.Length, (ULONG)sizeof(struct _URB_PIPE_REQUEST));
        Urb->UrbHeader.Status = USBD_STATUS_INVALID_URB_FUNCTION;
        return STATUS_INVALID_PARAMETER;
    }
 
    return STATUS_SUCCESS;
}

Referenced by HubPdoCachedDescriptor(), and HubPdoRouteUrb().

HubPdoWakeNotificationComplete()

static VOID NTAPI HubPdoWakeNotificationComplete ( _In_ WDFREQUEST  Request, _In_ WDFIOTARGET  Target, _In_ PWDF_REQUEST_COMPLETION_PARAMS  Params, _In_ WDFCONTEXT  Context  )

static

Definition at line 1616 of file childpdo.cpp.

{
    HubPdo* Pdo = (HubPdo*)Context;
 
    UNREFERENCED_PARAMETER(Request);
    UNREFERENCED_PARAMETER(Target);
    UNREFERENCED_PARAMETER(Params);
 
    DPRINT("Port %u wake notification done 0x%lx\n", Pdo->m_PortNumber, Params->IoStatus.Status);
    HubPdoIndicateWake(Pdo);
    KeSetEvent(&Pdo->m_WakeDone, IO_NO_INCREMENT, FALSE);
}

HubReadDeviceHardwareValues()

HubReadDeviceHardwareValues

(

Child

)

HubTakeClientRequest()

static WDFREQUEST NTAPI HubTakeClientRequest ( _In_ HubChild *  Child )

static

Definition at line 3451 of file childpdo.cpp.

{
    WDFREQUEST Request = Child->m_ClientRequest;
 
    Child->m_ClientRequest = NULL;
    Child->ClearState(ChildState::ActivityIdSet);
    return Request;
}

Referenced by DeviceMachine::CompleteClientRequest(), DeviceMachine::CompleteClientRequestFailed(), and DeviceMachine::CompleteClientRequestLastStatus().

HubUsbdStatusToNt()

static NTSTATUS NTAPI HubUsbdStatusToNt ( _In_ USBD_STATUS  Status )

static

Definition at line 220 of file childpdo.cpp.

{
    switch (Status)
    {
        case USBD_STATUS_SUCCESS:
        case USBD_STATUS_PORT_OPERATION_PENDING:
            return STATUS_SUCCESS;
 
        case USBD_STATUS_INSUFFICIENT_RESOURCES:
            return STATUS_INSUFFICIENT_RESOURCES;
 
        case USBD_STATUS_INVALID_URB_FUNCTION:
        case USBD_STATUS_INVALID_PARAMETER:
        case USBD_STATUS_INVALID_PIPE_HANDLE:
        case USBD_STATUS_BAD_START_FRAME:
            return STATUS_INVALID_PARAMETER;
 
        case USBD_STATUS_NOT_SUPPORTED:
            return STATUS_NOT_SUPPORTED;
 
        case USBD_STATUS_DEVICE_GONE:
            return STATUS_NO_SUCH_DEVICE;
 
        case USBD_STATUS_CANCELED:
            return STATUS_CANCELLED;
 
        default:
            return STATUS_UNSUCCESSFUL;
    }
}

Referenced by HubFailClientCheck().

HubWriteEnumerationData()

HubWriteEnumerationData

(

Child

)

if() [1/42]

if

(

!

Hub->HasFlag(HubFlag::InAcpiNamespace) &&Child->HasProperty(ChildProperty::NotRemovable)

)

if() [2/42]

if

(

!Child->

HasPropertyChildProperty::IsHub) &&!Child->HasProperty(ChildProperty::IsComposite

)

if() [3/42]

if

(

!

Known

)

Definition at line 3319 of file childpdo.cpp.

    {
        Status = WdfPdoInitAssignRawDevice(Init, &HubClassUnknown);
        if (!NT_SUCCESS(Status))
            DPRINT1("Raw device assignment failed 0x%lx\n", Status);
    }

if() [4/42]

if

(

!

NT_SUCCESSStatus

)

Definition at line 1000 of file childpdo.cpp.

    {
        DPRINT1("Hub did not power up for pre start 0x%lx\n", Status);
        return;
    }

if() [5/42]

if

(

!Pdo->

HasFlagPdoFlag::DeviceGone) &&Child->HasState(ChildState::WorkingDevice

)

-> m_FailRequests=FALSE

if() [6/42]

if

(

!Pdo->

HasFlagPdoFlag::Started

)

-> m_Child)

if() [7/42]

if

(

(Hub->m_ParentInfo.Flags &HUB_PARENT_HIGH_SPEED_CAPABLE)||Hub->m_ParentInfo.DeviceDescriptor.bcdUSB >=

0x0200

)

Definition at line 2348 of file childpdo.cpp.

    {
        Info->HubFlags.HubIsHighSpeedCapable = 1;
    }

if() [8/42]

if

(

Buffer

= = NULL

)

Definition at line 961 of file childpdo.cpp.

    {
        DPRINT1("No memory for the location string of port %u\n", Child->m_Port->Number());
        return STATUS_INSUFFICIENT_RESOURCES;
    }

if() [9/42]

if

(

Child->

HasPropertyChildProperty::DualRole

)

-> ClearProperty(ChildProperty::DualRole)

if() [10/42]

if

(

Child->

HasPropertyChildProperty::IsHub

)

Definition at line 1222 of file childpdo.cpp.

    {
        if (Hub->m_Parent.HubDepth >= Child->m_Port->m_Info.TotalHubDepth)
        {
            DPRINT1("Hub on port %u nested too deeply, depth %u\n", Pdo->m_PortNumber, Hub->m_Parent.HubDepth);
            Child->m_Port->m_ConnectionStatus = DeviceHubNestedTooDeeply;
            HubWmiNotifyHubNestedTooDeeply(Hub, Pdo->m_PortNumber);
            return STATUS_UNSUCCESSFUL;
        }
 
        InterfaceGuid = &GUID_DEVINTERFACE_USB_HUB;
    }

if() [11/42]

if

(

Child->

HasPropertyChildProperty::UxdReserved

)

Definition at line 2370 of file childpdo.cpp.

    {
        Info->Reserved[18] = 1;
        RtlCopyMemory(&Info->UxdSettings, &Child->m_Uxd, sizeof(Info->UxdSettings));
    }

if() [12/42]

if

(

D3ColdSupport

)

-> m_Child->SetState(ChildState::D3ColdEnabledByDriver)

if() [13/42]

if

(

Device !

= NULL

)

Definition at line 3399 of file childpdo.cpp.

    {
        Child->m_Pdo = NULL;
        WdfObjectDelete(Device);
    }

if() [14/42]

if

(

Hub->

HasFlagHubFlag::MultiTtHub

)

Definition at line 2354 of file childpdo.cpp.

    {
        Info->HubFlags.HubIsMultiTt = 1;
        Info->HubFlags.HubIsMultiTtCapable = 1;
    }

if() [15/42]

if

(

Hub->

HasFlagHubFlag::WakeOnConnect

)

-> HubFlags.HubIsArmedWakeOnConnect=1

if() [16/42]

if

(

Hub->

IsRootHub()

)

-> HubFlags.HubIsRoot=1

if() [17/42]

if

(

Hub->

m_MaxPortPower = =100

)

-> HubFlags.HubIsBusPowered=1

if() [18/42]

if

(

Hub->m_Parent.

HubSpeed = =UsbHighSpeed

)

-> HubFlags.HubIsHighSpeed=1

if() [19/42]

if

(

HubUsb4NeedsHostPower(Child)

)

Definition at line 1207 of file childpdo.cpp.

    {
        if (Hub->m_TunneledDevicesSkipU2)
        {
            DPRINT("Port %u keeps U2 off for its tunneled device\n", Pdo->m_PortNumber);
            InterlockedOr((PLONG)&Child->m_Hacks, (LONG)ChildHack::DisableLpm);
        }
 
        HubUsb4AcquireHostPower(Child->m_Port);
    }

if() [20/42]

if

(

HubUsb4NeedsHostPower(Pdo->m_Child)

)

if() [21/42]

if

(

Info->Length !

= sizeof(*Info)

)

Definition at line 2337 of file childpdo.cpp.

    {
        DPRINT1("Port %u config info length %lu, expected %lu\n",
                Pdo->m_PortNumber, Info->Length, (ULONG)sizeof(*Info));
        return STATUS_BUFFER_TOO_SMALL;
    }

if() [22/42]

if

(

Info

= = NULL || Info->Version != 1

)

Definition at line 2331 of file childpdo.cpp.

    {
        DPRINT1("Port %u config info %p has a bad version\n", Pdo->m_PortNumber, Info);
        return STATUS_INVALID_PARAMETER;
    }

if() [23/42]

if

(

Init !

= NULL

)

if() [24/42]

if

(

Init

= = NULL

)

Definition at line 3294 of file childpdo.cpp.

    {
        DPRINT1("No PDO init for port %u\n", Port->Number());
        return FALSE;
    }

if() [25/42]

if

(

Known

)

Definition at line 3279 of file childpdo.cpp.

    {
        Child->SetState(ChildState::WorkingDevice);
    }

if() [26/42]

if

(

NT_SUCCESS(Status) &&*D3ColdSupported &&Pdo->m_Child->m_Port->HasProperty(PortProperty::Removable)

)

Definition at line 607 of file childpdo.cpp.

    {
        DPRINT1("Platform claims D3cold for a removable port %u\n", Pdo->m_PortNumber);
    }

if() [27/42]

if

(

NT_SUCCESS(Status)

)

Definition at line 2380 of file childpdo.cpp.

    {
        RtlZeroMemory(&FriendlyName, sizeof(FriendlyName));
        FriendlyName.LengthInBytes = Child->m_FriendlyNameLength;
        FriendlyName.Buffer = Child->m_FriendlyName;
        Status = HubIdListCopy(&Info->DeviceDescription, &FriendlyName);
    }

if() [28/42]

if

(

Pdo->HasFlag(PdoFlag::Started)||Stack->Parameters.QueryId.IdType !

= BusQueryDeviceID || KeGetCurrentIrql() != PASSIVE_LEVEL

)

Definition at line 992 of file childpdo.cpp.

    {
        return;
    }

if() [29/42]

if

(

Pdo->

HasFlagPdoFlag::WasResetAtResume

)

if() [30/42]

if

(

Pdo->m_AcpiD3Cold.

GetD3ColdCapability = = NULL

)

Definition at line 600 of file childpdo.cpp.

    {
        *D3ColdSupported = FALSE;
        return STATUS_SUCCESS;
    }

if() [31/42]

if

(

Pdo->m_AcpiD3Cold.GetIdleWakeInfo !

= NULL

)

Definition at line 565 of file childpdo.cpp.

    {
        Status = Pdo->m_AcpiD3Cold.GetIdleWakeInfo(Pdo->m_AcpiD3Cold.Context,
                                                   SystemPowerState,
                                                   DeepestWakeableDstate);
        if (NT_SUCCESS(Status))
            return Status;
    }

if() [32/42]

if

(

Pdo->m_AcpiD3Cold.GetLastTransitionStatus !

= NULL

)

Definition at line 645 of file childpdo.cpp.

    {
        Pdo->m_AcpiD3Cold.GetLastTransitionStatus(Pdo->m_AcpiD3Cold.Context, LastTransitionStatus);
        if (*LastTransitionStatus == LastDStateTransitionD3cold)
            return;
    }

if() [33/42]

if

(

Pdo->m_AcpiD3Cold.SetD3ColdSupport !

= NULL

)

-> m_AcpiD3Cold.SetD3ColdSupport(Pdo->m_AcpiD3Cold.Context, D3ColdSupport)

if() [34/42]

if

(

Pdo->m_Hub->m_Capabilities.SystemWake >=SystemPowerState &&

Child->HasProperty(ChildProperty::RemoteWakeCapable)||Child->HasProperty(ChildProperty::IsHub)

)

Definition at line 574 of file childpdo.cpp.

    {
        *DeepestWakeableDstate = DeviceWakeDepthD2;
    }

if() [35/42]

if

(

Pdo->m_SymbolicLink !

= NULL

)

-> m_SymbolicLink, SymbolicLinkName)

if() [36/42]

if

(

Pdo->

m_SymbolicLink = = NULL

)

Definition at line 1246 of file childpdo.cpp.

    {
        WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
        Attributes.ParentObject = Device;
 
        Status = WdfStringCreate(NULL, &Attributes, &Pdo->m_SymbolicLink);
        if (!NT_SUCCESS(Status))
        {
            DPRINT1("Port %u symbolic link string not created 0x%lx\n", Pdo->m_PortNumber, Status);
            return Status;
        }
    }

if() [37/42]

if

(

Pdo->

TestAndClearFlagPdoFlag::QueryRemoved

)

if() [38/42]

if

(

Pdo->

TestAndClearFlagPdoFlag::QueryStopped

)

if() [39/42]

if

(

Referenced

)

-> m_Object,(PVOID) HubTagPdo)

if() [40/42]

if

(

TargetState !

= WdfPowerDeviceD3Final &&Action==PowerActionNone

)

if() [41/42]

else if

(

TargetState

= = WdfPowerDeviceD3Final && Action == PowerActionNone

)

Definition at line 1546 of file childpdo.cpp.

    {
        Event = DsmEvent::PdoPowerDownFinal;
    }

if() [42/42]

if

(

WdfTimerStop(Child->m_BandwidthRetryTimer, TRUE)

)

Definition at line 1580 of file childpdo.cpp.

    {
        DPRINT1("Port %u ran out of bandwidth\n", Pdo->m_PortNumber);
        HubWmiNotifyInsufficientBandwidth(Pdo->m_Hub, Pdo->m_PortNumber);
    }

Initialize()

Pdo m_Idle Initialize

(

Pdo

)

IoCopyCurrentIrpStackLocationToNext()

IoCopyCurrentIrpStackLocationToNext

(

Irp

)

IoSetCompletionRoutine()

IoSetCompletionRoutine	(	Irp	,
		HubPdoSignalCompletion	,
		&	Event,
		TRUE	,
		TRUE	,
		TRUE
	)

Number()

Port Number

(

)

PAGED_CODE()

PAGED_CODE

(

)

Referenced by _IRQL_requires_().

Post() [1/3]

Child Post

(

Event

)

Referenced by CdCleanupIrpContext(), and NtfsCachedRead().

Post() [2/3]

Pdo m_Idle Post	(	IdleEvent::PoweredUp	,
		NULL
	)

Post() [3/3]

Pdo m_Idle Post	(	IdleEvent::Start	,
		NULL
	)

RtlInitEmptyUnicodeString()

RtlInitEmptyUnicodeString	(	SymbolicLinkName	,
		NULL	,
		0
	)

Referenced by _Function_class_(), _IRQL_requires_(), _main(), _Success_(), _tmain(), AddNTOSInstallation(), ApphelppInitDebugLevel(), ArbpOpenPolicySubkey(), AVrfpLoadAndInitializeProvider(), BaseCreateVDMEnvironment(), BaseInitApphelp(), BaseInitializeStaticServerData(), BasepIsCurDirAllowedForPlainExeNames(), BasepOpenFileForMove(), BuildSubSysCommandLine(), BuildUserModeWindowStationName(), CheckSid__(), ClassNameToVersion(), cleanup(), CmpAddDriverToList(), CmpCmdHiveOpen(), CmpInitializeHive(), CmpInitializeHiveList(), CmpInitializeRegistryNode(), CmpInitializeSystemHive(), CmpIsSafe(), CmpOpenHiveFiles(), CmpRemoveFromHiveFileList(), CmpSetVersionData(), CNtObjectFolder::CompareIDs(), ConvertNtPathToWin32Path(), CreateDeviceFromRegistry(), CreateProcessInternalW(), dempIsFileMatch(), EjectFloppy(), ElfCloseFile(), ElfCreateFile(), EmulatorInitialize(), EnumerateInstallations(), EraseLine(), ExpandEnvironmentStringsA(), ExpandEnvironmentStringsW(), ExpInitializeExecutive(), ExpLoadInitialProcess(), FltpAttachToFileSystemDevice(), GetClassNameW(), CNtObjectFolder::GetDetailsEx(), CNtObjectFolder::GetDetailsOf(), GetEnvironmentVariableA(), GetEnvironmentVariableW(), GetFinalPathNameByHandleW(), GetKeyboardLayoutNameW(), GetSourcePaths(), GetSystemVersionString(), HalpRegisterPciDebuggingDeviceInfo(), HubUsb4OpenWorkItem(), IntGdiAddFontResourceSingle(), IntGdiRemoveFontResourceSingle(), IntResolveDesktop(), IntSetAconData(), IntSetCursorData(), IopLogWorker(), IopQueryDeviceDescription(), IopSeparateSymbolicLink(), IopStartRamdisk(), IopStoreSystemPartitionInformation(), IsShortName_U(), IsValidNTOSInstallationByHandle(), KsepGetShimsFromRegistry(), LDEVOBJ_bLoadImage(), LDEVOBJ_pLoadDriver(), LdrGetDllHandleEx(), LdrLoadDll(), LdrpFreeUnicodeString(), LdrpInitializeDotLocalSupport(), LdrpInitializeProcess(), LdrpLoadDll(), LdrpLoadImportModule(), LdrpSnapThunk(), LdrpUpdateLoadCount2(), LoadSymbolsRoutine(), LpcpCreatePort(), LsapSetLogonSessionData(), MiQueryMemorySectionName(), MountFloppy(), NpCancelWaiter(), NtGdiOpenDCW(), NtQueryDirectoryObject(), NtQueryInformationThread(), NtQuerySystemEnvironmentValue(), NtUserChangeDisplaySettings(), NtUserEnumDisplayDevices(), NtUserEnumDisplaySettings(), NtUserLoadKeyboardLayoutEx(), NtVdmConfigureBios(), NtVdmConfigureFloppy(), NtVdmConfigureHDD(), NtVdmConfigureRom(), ObpCaptureObjectCreateInformation(), ObpCaptureObjectName(), ObpDeleteObject(), ObpDereferenceNameInfo(), ObQueryNameString(), ParseArcName(), PiPropBuildValuePath(), PiPropInitLocale(), PnpRootCreateDevice(), PrivMoveFileIdentityW(), ProbeAndCaptureObjectAttributes(), ProbeAndCaptureUnicodeStringOrAtom(), ProcessPortMessage(), RealGetWindowClassW(), RegCreateKeyExA(), RegDeleteKeyExA(), RegLoadKeyA(), RegOpenKeyExA(), RegQueryInfoKeyA(), RegQueryValueExA(), RegReplaceKeyA(), RegRestoreKeyA(), RegSaveKeyA(), RegSaveKeyExA(), RegUnLoadKeyA(), CNtObjectFolder::ResolveSymLink(), RtlConvertUiListToApiList(), RtlDosApplyFileIsolationRedirection_Ustr(), RtlDosSearchPath_Ustr(), RtlFormatCurrentUserKeyPath(), RtlpCallQueryRegistryRoutine(), RtlpDosPathNameToRelativeNtPathName_Ustr(), RtlpGetRegistryHandle(), RtlpNtQueryValueKey(), RtlpNtSetValueKey(), RtlpWin32NTNameToNtPathName_U(), RtlQueryRegistryValues(), RtlSetCurrentDirectory_U(), RunTestCases(), RxCanonicalizeNameAndObtainNetRoot(), RxCreateTreeConnect(), RxFirstCanonicalize(), RxPrefixClaim(), ScmConvertToBootPathName(), SdbpMatchExe(), SdbpPropagateEnvLayers(), SdbUnregisterDatabase(), SeiAddHooks(), SeiInitDebugSupport(), SetupLdrLoadNlsData(), SmLookupSubsystem(), SmpCreateDynamicEnvironmentVariables(), SmpInvokeAutoChk(), SmpParseCommandLine(), SmpProcessModuleImports(), SmpTranslateSystemPartitionInformation(), START_TEST(), test_allocations(), test_dllnames(), Test_RtlCultureNameToLCID(), Test_RtlLCIDToCultureName(), Test_RtlLcidToLocaleName(), Test_RtlUnicodeStringPrintf(), Test_RtlUnicodeStringPrintfEx(), TestBuffers(), TestIoVolumeDeviceToDosName(), TestMessageHandler(), TestQueryLink(), TestRedirection(), TestRelativeNames(), TestUpcaseUnicodeString(), UcxBuildRootHubHardwareIds(), UcxParentGetHubSymbolicName(), UserpFormatMessages(), UserpGetClientFileName(), UserServerHardError(), VersionRegisterClass(), vfatGetFCBForFile(), VfatSetRenameInformation(), WinLdrAddDriverToList(), and WinLdrGetNLSNames().

RtlZeroMemory()

RtlZeroMemory	(	Info	,
		sizeof *	Info
	)

SetFlag() [1/2]

Pdo SetFlag

(

PdoFlag::IdleMachineStarted

)

SetFlag() [2/2]

Pdo SetFlag

(

PdoFlag::Started

)

UNREFERENCED_PARAMETER() [1/4]

UNREFERENCED_PARAMETER

(

IoResourceRequirementsList

)

UNREFERENCED_PARAMETER() [2/4]

UNREFERENCED_PARAMETER

(

PreviousState

)

UNREFERENCED_PARAMETER() [3/4]

UNREFERENCED_PARAMETER

(

ResourcesRaw

)

UNREFERENCED_PARAMETER() [4/4]

UNREFERENCED_PARAMETER

(

ResourcesTranslated

)

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME()

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME	(	HubPdoIrpWork	,
		HubGetPdoIrpWork
	)

WdfDeviceInitSetDeviceType()

WdfDeviceInitSetDeviceType	(	Init	,
		FILE_DEVICE_UNKNOWN
	)

Referenced by Bus_CreatePdo(), DriverEvtDeviceAdd(), and SklHdAudBusEvtDeviceAdd().

WdfDeviceInitSetExclusive()

WdfDeviceInitSetExclusive	(	Init	,
		FALSE
	)

Referenced by DriverEvtDeviceAdd().

WdfDeviceInitSetRemoveLockOptions()

WdfDeviceInitSetRemoveLockOptions	(	Init	,
		&	RemoveLock
	)

Referenced by DriverEvtDeviceAdd().

WdfDeviceResumeIdle()

WdfDeviceResumeIdle

(

HubDevice

)

WdfDeviceSetSpecialFileSupport() [1/4]

WdfDeviceSetSpecialFileSupport	(	Device	,
		WdfSpecialFileBoot	,
		TRUE
	)

WdfDeviceSetSpecialFileSupport() [2/4]

WdfDeviceSetSpecialFileSupport	(	Device	,
		WdfSpecialFileDump	,
		TRUE
	)

WdfDeviceSetSpecialFileSupport() [3/4]

WdfDeviceSetSpecialFileSupport	(	Device	,
		WdfSpecialFileHibernation	,
		TRUE
	)

WdfDeviceSetSpecialFileSupport() [4/4]

WdfDeviceSetSpecialFileSupport	(	Device	,
		WdfSpecialFilePaging	,
		TRUE
	)

Referenced by UcxRootHub::CreatePdo(), and XhciCreateFdo().

WdfDeviceWdmDispatchPreprocessedIrp()

WdfDeviceWdmDispatchPreprocessedIrp	(	Device	,
		Irp
	)

Referenced by HubPdoPassDown(), HubPdoPreprocessSetPower(), RequestProcessSetPower(), UcxEvtRootHubPreprocessQueryInterface(), UcxEvtRootHubPreprocessSetPower(), XhciEvtPreprocessInternalIoctl(), and XhciEvtPreprocessSetPower().

WdfObjectReferenceWithTag()

WdfObjectReferenceWithTag	(	Child->	m_Object,
		(PVOID)	HubTagPdo
	)

WdfPdoInitAllowForwardingRequestToParent()

WdfPdoInitAllowForwardingRequestToParent

(

Init

)

Referenced by UcxRootHub::CreatePdo().

Variable Documentation

__pad0__

Failed __pad0__

Definition at line 3393 of file childpdo.cpp.

Action

Action = WdfDeviceGetSystemPowerAction(Device)

Definition at line 1530 of file childpdo.cpp.

Attributes

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE& Attributes

Definition at line 1190 of file childpdo.cpp.

Referenced by HubPdoPowerIrpComplete().

Buffer

WCHAR Buffer[32] = (PWCHAR)ExAllocatePoolWithTag(PagedPool, Count * sizeof(WCHAR), HUB_TAG_DEVICE)

Definition at line 953 of file childpdo.cpp.

Referenced by HubPdoCachedDescriptor(), and HubPdoMsFeatureDescriptor().

Child

HubWaitForPnpEvent& Child = Pdo->m_Child

Definition at line 264 of file childpdo.cpp.

Count

const SIZE_T Count = 10

Definition at line 952 of file childpdo.cpp.

D3ColdSupport

_In_ BOOLEAN D3ColdSupport

Initial value:

{
    HubPdo* Pdo = (HubPdo*)Context

Definition at line 537 of file childpdo.cpp.

D3ColdSupported

* D3ColdSupported

Initial value:

{
    HubPdo* Pdo = (HubPdo*)Context

Definition at line 593 of file childpdo.cpp.

DeepestWakeableDstate

_In_ SYSTEM_POWER_STATE _Out_ PDEVICE_WAKE_DEPTH DeepestWakeableDstate

Initial value:

{
    HubPdo* Pdo = (HubPdo*)Context

Definition at line 557 of file childpdo.cpp.

Device

WDFDEVICE Device

Initial value:

{
    
    DECLARE_CONST_UNICODE_STRING(Sddl, L"D:P(A;;GA;;;SY)(A;;GRGWGX;;;BA)(A;;GRGW;;;WD)(A;;GR;;;RC)")

Definition at line 3064 of file childpdo.cpp.

Referenced by if().

else

else

Initial value:

{
        *DeepestWakeableDstate = DeviceWakeDepthNotWakeable

Definition at line 579 of file childpdo.cpp.

Event

DsmEvent Event

Definition at line 259 of file childpdo.cpp.

Referenced by HubPdoQueueAndWait().

EvtCleanupCallback

Attributes EvtCleanupCallback = HubPdoEvtCleanup

Definition at line 3082 of file childpdo.cpp.

FALSE

return FALSE

Definition at line 3408 of file childpdo.cpp.

Referenced by HubFailClientCheck(), HubFindSelectedInterface(), HubPdoEvtParentInterfaceQuery(), HubPdoPowerIrpComplete(), HubPdoPreprocessInternalIoctl(), HubPdoQueueAndWait(), HubPdoSignalCompletion(), HubPdoSyncComplete(), HubPdoWakeNotificationComplete(), and if().

FriendlyName

USB_ID_STRING FriendlyName

Definition at line 2328 of file childpdo.cpp.

Referenced by if(), and Test_DeviceBuiltins().

Hub

HubFdo* Hub = Pdo->m_Hub

Definition at line 1189 of file childpdo.cpp.

Referenced by HubPdoEvtParentInterfaceQuery(), HubPdoFillHubInfo(), HubPdoTopologyAddress(), and if().

HubCapFullSpeedCompatible

const GUID HubCapFullSpeedCompatible

static

Initial value:

=
    { 0xcde43191, 0x1fad, 0x4120, { 0xa7, 0xab, 0x74, 0x09, 0x56, 0xc6, 0x6f, 0x37 } }

Definition at line 98 of file childpdo.cpp.

Referenced by HubPdoQueryCapability().

HubCapLowSpeedCompatible

const GUID HubCapLowSpeedCompatible

static

Initial value:

=
    { 0xad6f2a13, 0xc4d1, 0x4925, { 0x83, 0xcc, 0x96, 0x85, 0x7a, 0x24, 0x31, 0xd9 } }

Definition at line 100 of file childpdo.cpp.

Referenced by HubPdoQueryCapability().

HubClassUnknown

const GUID HubClassUnknown

static

Initial value:

=
    { 0x4d36e97e, 0xe325, 0x11ce, { 0xbf, 0xc1, 0x08, 0x00, 0x2b, 0xe1, 0x03, 0x18 } }

Definition at line 94 of file childpdo.cpp.

Referenced by if().

HubDevice

WDFDEVICE HubDevice = Pdo->m_Hub->m_Device

Definition at line 989 of file childpdo.cpp.

Referenced by UcxUsbDevice::CreateFromHub(), HubWmiQueryHubNode(), and UcxHubQueryControllerBus().

HubKeyBillboardInfo

const DEVPROPKEY HubKeyBillboardInfo

static

Initial value:

=
    { { 0xb1049018, 0x6da0, 0x4490, { 0xb0, 0xc9, 0x1e, 0x91, 0xf1, 0xf5, 0x5b, 0xd7 } }, 2 }

Definition at line 104 of file childpdo.cpp.

HubKeyDualRoleFeatures

const DEVPROPKEY HubKeyDualRoleFeatures

static

Initial value:

=
    { { 0x32d615be, 0x32f4, 0x4fdc, { 0xbc, 0x48, 0xfc, 0x54, 0x30, 0x1a, 0xb6, 0xc4 } }, 2 }

Definition at line 106 of file childpdo.cpp.

HubKeyUsb4TunnelState

const DEVPROPKEY HubKeyUsb4TunnelState

static

Initial value:

=
    { { 0xb5a825b8, 0x3907, 0x40b5, { 0xab, 0xca, 0x84, 0x51, 0xe2, 0x45, 0x3d, 0x5f } }, 3 }

Definition at line 108 of file childpdo.cpp.

HubLpmDeviceSettings

const GUID HubLpmDeviceSettings[HUB_PDO_LPM_SETTINGS]

static

Initial value:

=
{
    { 0xfb093825, 0xbf59, 0x4fe6, { 0x8b, 0x6f, 0xaf, 0xd6, 0x71, 0x4c, 0x69, 0xe5 } },
    { 0x903281ea, 0xc859, 0x47a9, { 0x89, 0x01, 0x7a, 0x11, 0x8c, 0x7b, 0xf5, 0xa7 } },
    { 0xa7b5d35e, 0xc12c, 0x4f36, { 0xa4, 0x4f, 0x00, 0x62, 0x8f, 0x90, 0x03, 0x88 } },
    { 0x300c0440, 0xee77, 0x4c1b, { 0xaf, 0x99, 0x3a, 0x33, 0xf8, 0xa9, 0xca, 0x5d } },
    { 0xd4e98f31, 0x5ffe, 0x4ce1, { 0xbe, 0x31, 0x1b, 0x38, 0xb3, 0x84, 0xc0, 0x09 } }
}

Definition at line 112 of file childpdo.cpp.

Referenced by HubPdoLpmSettingChanged().

HubLpmHubSettings

const GUID HubLpmHubSettings[HUB_PDO_LPM_SETTINGS]

static

Initial value:

=
{
    { 0xc5f91e9d, 0x0ced, 0x43f2, { 0x90, 0x5e, 0x8f, 0x9d, 0x38, 0xe9, 0x33, 0x39 } },
    { 0x34751a37, 0xe607, 0x452a, { 0xb9, 0xf7, 0xd0, 0x20, 0xfc, 0x5c, 0xd0, 0xdc } },
    { 0x329423dd, 0x222f, 0x4b04, { 0x81, 0x5b, 0x08, 0xc1, 0xa6, 0xd8, 0x9c, 0x8e } },
    { 0xbbfbadaf, 0x7520, 0x491a, { 0x91, 0x0d, 0x4a, 0x2c, 0xee, 0x72, 0x20, 0x3f } },
    { 0xd4e98f31, 0x5ffe, 0x4ce1, { 0xbe, 0x31, 0x1b, 0x38, 0xb3, 0x84, 0xc0, 0x09 } }
}

Definition at line 121 of file childpdo.cpp.

Referenced by HubPdoLpmSettingChanged().

HubPdoEvtCleanup

EVT_WDF_OBJECT_CONTEXT_CLEANUP HubPdoEvtCleanup

static

Definition at line 165 of file childpdo.cpp.

HubPdoEvtCompletePowerIrp

EVT_WDF_WORKITEM HubPdoEvtCompletePowerIrp

static

Definition at line 173 of file childpdo.cpp.

Referenced by HubPdoPowerIrpComplete().

HubPdoEvtD0Entry

EVT_WDF_DEVICE_D0_ENTRY HubPdoEvtD0Entry

static

Definition at line 152 of file childpdo.cpp.

HubPdoEvtD0Exit

EVT_WDF_DEVICE_D0_EXIT HubPdoEvtD0Exit

static

Definition at line 153 of file childpdo.cpp.

HubPdoEvtDisableWakeAtBus

EVT_WDF_DEVICE_DISABLE_WAKE_AT_BUS HubPdoEvtDisableWakeAtBus

static

Definition at line 162 of file childpdo.cpp.

HubPdoEvtEnableWakeAtBus

EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS HubPdoEvtEnableWakeAtBus

static

Definition at line 161 of file childpdo.cpp.

HubPdoEvtIoDeviceControl

EVT_WDF_IO_QUEUE_IO_DEVICE_CONTROL HubPdoEvtIoDeviceControl

static

Definition at line 172 of file childpdo.cpp.

HubPdoEvtIoInternalDeviceControl

EVT_WDF_IO_QUEUE_IO_INTERNAL_DEVICE_CONTROL HubPdoEvtIoInternalDeviceControl

static

Definition at line 171 of file childpdo.cpp.

HubPdoEvtParentInterfaceQuery

EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST HubPdoEvtParentInterfaceQuery

static

Definition at line 170 of file childpdo.cpp.

HubPdoEvtPrepareHardware

EVT_WDF_DEVICE_PREPARE_HARDWARE HubPdoEvtPrepareHardware

static

Definition at line 154 of file childpdo.cpp.

HubPdoEvtQueryRemove

EVT_WDF_DEVICE_QUERY_REMOVE HubPdoEvtQueryRemove

static

Definition at line 160 of file childpdo.cpp.

HubPdoEvtQueryStop

EVT_WDF_DEVICE_QUERY_STOP HubPdoEvtQueryStop

static

Definition at line 159 of file childpdo.cpp.

HubPdoEvtReleaseHardware

EVT_WDF_DEVICE_RELEASE_HARDWARE HubPdoEvtReleaseHardware

static

Definition at line 155 of file childpdo.cpp.

HubPdoEvtReportedMissing

EVT_WDF_DEVICE_REPORTED_MISSING HubPdoEvtReportedMissing

static

Definition at line 163 of file childpdo.cpp.

HubPdoEvtResourceRequirementsQuery

EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY HubPdoEvtResourceRequirementsQuery

static

Definition at line 164 of file childpdo.cpp.

HubPdoEvtSelfManagedIoStart

EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT HubPdoEvtSelfManagedIoStart

static

Definition at line 157 of file childpdo.cpp.

HubPdoEvtSelfManagedIoSuspend

EVT_WDF_DEVICE_SELF_MANAGED_IO_SUSPEND HubPdoEvtSelfManagedIoSuspend

static

Definition at line 158 of file childpdo.cpp.

HubPdoEvtSurpriseRemoval

EVT_WDF_DEVICE_SURPRISE_REMOVAL HubPdoEvtSurpriseRemoval

static

Definition at line 156 of file childpdo.cpp.

HubPdoLpmSettingChanged

POWER_SETTING_CALLBACK HubPdoLpmSettingChanged

static

Definition at line 175 of file childpdo.cpp.

HubPdoPreprocessInternalIoctl

EVT_WDFDEVICE_WDM_IRP_PREPROCESS HubPdoPreprocessInternalIoctl

static

Definition at line 166 of file childpdo.cpp.

HubPdoPreprocessIoctl

EVT_WDFDEVICE_WDM_IRP_PREPROCESS HubPdoPreprocessIoctl

static

Definition at line 167 of file childpdo.cpp.

HubPdoPreprocessPnp

EVT_WDFDEVICE_WDM_IRP_PREPROCESS HubPdoPreprocessPnp

static

Definition at line 168 of file childpdo.cpp.

HubPdoPreprocessSetPower

EVT_WDFDEVICE_WDM_IRP_PREPROCESS HubPdoPreprocessSetPower

static

Definition at line 169 of file childpdo.cpp.

HubPdoWakeNotificationComplete

EVT_WDF_REQUEST_COMPLETION_ROUTINE HubPdoWakeNotificationComplete

static

Definition at line 174 of file childpdo.cpp.

Referenced by HubPdoSendWakeNotification().

HubSetSystemWakeDevice

PFN_HUB_SET_SYSTEM_WAKE_DEVICE HubSetSystemWakeDevice

static

Definition at line 149 of file childpdo.cpp.

Referenced by DeviceMachine::MarkSystemWakeSource().

HubSetSystemWakeDeviceResolved

BOOLEAN HubSetSystemWakeDeviceResolved

static

Definition at line 150 of file childpdo.cpp.

HubTagPdo

const char HubTagPdo[] = "hub child pdo"

static

Definition at line 17 of file childpdo.cpp.

Index

ULONG Index

Definition at line 3073 of file childpdo.cpp.

Referenced by HubInitInterfaceInformation(), and HubPdoGetHubName().

Info

_Inout_opt_ PHUB_DEVICE_CONFIG_INFO Info

Initial value:

{
    HubChild* Child = Pdo->m_Child

Definition at line 2324 of file childpdo.cpp.

Init

Init

(

void

)

= WdfPdoInitAllocate(Hub->m_Device)

Definition at line 3269 of file childpdo.cpp.

InterfaceGuid

const GUID* InterfaceGuid

Definition at line 1191 of file childpdo.cpp.

Referenced by FxQueryInterface::_FormatIrp(), CreateSymbolicLink(), GetDeviceListInterfaces(), GetInterfaceProperties(), if(), InstallOneInterface(), IpDeleteArpCache(), IpDumpFn(), IpShowAdapters(), KsCreateBusEnumObject(), NsGetFriendlyNameFromIfName(), NsGetIfNameFromFriendlyName(), OpenAdapterHandle(), OpenDeviceList(), PNP_GetInterfaceDeviceList(), PNP_GetInterfaceDeviceListSize(), PNP_RegisterDeviceClassAssociation(), SetInterfaceProperties(), SETUP_CreateInterfaceList(), and SetupDiInstallDeviceInterfaces().

IoResourceRequirementsList

_In_ WDFIORESREQLIST IoResourceRequirementsList

Initial value:

{
    HubPdo* Pdo = HubGetPdoContext(Device)

Definition at line 1385 of file childpdo.cpp.

Irp

_In_ PIRP Irp

Initial value:

{
    KEVENT Event

Definition at line 360 of file childpdo.cpp.

Referenced by HubPdoPowerIrpComplete().

Known

_In_ BOOLEAN Known

Initial value:

{
    HubFdo* Hub = Child->m_Hub

Definition at line 3264 of file childpdo.cpp.

Referenced by PrintAttributeInfo(), DeviceMachine::SameDeviceConnected(), and UniataFindBusMasterController().

LastTransitionStatus

* LastTransitionStatus

Initial value:

{
    HubPdo* Pdo = (HubPdo*)Context

Definition at line 639 of file childpdo.cpp.

Length

Info Length = sizeof(*Info)

Definition at line 2346 of file childpdo.cpp.

Referenced by HubPdoRecordFailure().

LocationStrings

* LocationStrings

Initial value:

{
    HubChild* Child = (HubChild*)Context

Definition at line 949 of file childpdo.cpp.

Referenced by locintrf_GetLocationString(), and UcxGetLocationString().

m_Child

Pdo m_Child = Child

Definition at line 3339 of file childpdo.cpp.

m_ClientContractVersion

Pdo m_ClientContractVersion = HUB_PDO_CONTRACT_UNKNOWN

Definition at line 3342 of file childpdo.cpp.

m_Device

Pdo m_Device = Device

Definition at line 3337 of file childpdo.cpp.

Referenced by FxPkgFdo::_PnpPassDown(), FxPkgPdo::_PnpSetLock(), _Releases_lock_(), FxPkgPdo::AddEjectionDevice(), FxPkgFdo::CreateDefaultDeviceList(), FxPkgFdo::DeleteSymbolicLinkOverload(), FxPkgPdo::DeleteSymbolicLinkOverload(), FxPkgFdo::DispatchDeviceSetPower(), FxPkgPdo::DispatchDeviceSetPower(), FxPkgFdo::DispatchSystemSetPower(), FxPkgPdo::DispatchSystemSetPower(), FxPkgFdo::HandleQueryPnpDeviceStateCompletion(), if(), FxPkgFdo::Initialize(), FxPkgPdo::Initialize(), FxPkgPdo::PnpEventEjectHardwareOverload(), FxPkgPdo::PnpEventPdoRemovedOverload(), FxPkgFdo::PnpFilterResourceRequirements(), FxPkgPdo::PnpQueryCapabilities(), FxPkgPdo::PnpQueryDeviceRelations(), FxPkgPdo::PnpQueryResourceRequirements(), FxPkgPdo::PnpQueryResources(), FxPkgFdo::PnpSendStartDeviceDownTheStackOverload(), FxPkgFdo::PostCreateDeviceInitialize(), FxPkgPdo::PowerCheckParentOverload(), FxPkgPdo::PowerDisableWakeAtBusOverload(), FxPkgPdo::PowerEnableWakeAtBusOverload(), FxPkgPdo::PowerNotifyParentChildWakeArmed(), FxPkgPdo::PowerNotifyParentChildWakeDisarmed(), FxPkgPdo::PowerParentPowerDereference(), FxPkgFdo::ProcessRemoveDeviceOverload(), FxPkgPdo::ProcessRemoveDeviceOverload(), FxPkgFdo::QueryForPowerThread(), FxPkgFdo::QueryForReenumerationInterface(), FxPkgFdo::RaiseDevicePower(), and FxPkgFdo::SendIrpSynchronously().

m_FailRequests

else Pdo m_FailRequests = TRUE

Definition at line 1299 of file childpdo.cpp.

m_Hub

Pdo m_Hub = Hub

Definition at line 3338 of file childpdo.cpp.

m_LpmPolicy

Child m_LpmPolicy = HUB_LPM_POLICY_LINK_BITS

Definition at line 3386 of file childpdo.cpp.

m_Pdo

Child m_Pdo = Pdo

Definition at line 3360 of file childpdo.cpp.

m_PnpStatus

return Child m_PnpStatus

Definition at line 267 of file childpdo.cpp.

m_PortNumber

Pdo m_PortNumber = Port->Number()

Definition at line 1510 of file childpdo.cpp.

m_Reported

Pdo m_Reported = TRUE

Definition at line 3384 of file childpdo.cpp.

m_WdfPowerState

Pdo m_WdfPowerState = WdfPowerDeviceD0

Definition at line 1505 of file childpdo.cpp.

Name

UNICODE_STRING Name

Definition at line 3071 of file childpdo.cpp.

Referenced by for(), and HubPdoGetHubName().

Pdo

KeInitializeEvent& Pdo = HubGetPdoContext(Device)

Definition at line 1187 of file childpdo.cpp.

Referenced by HubPdoAnswerD3Cold(), HubPdoDispatchIoctl(), and HubPdoEvtParentInterfaceQuery().

Port

HubPort* Port = Child->m_Port

Definition at line 3267 of file childpdo.cpp.

Referenced by HubEvtBandwidthRetryTimer(), HubPdoEvtParentInterfaceQuery(), and if().

PreviousState

_In_ WDF_POWER_DEVICE_STATE PreviousState

Initial value:

{
    HubPdo* Pdo = HubGetPdoContext(Device)

Definition at line 1494 of file childpdo.cpp.

Referenced

Referenced = FALSE

Definition at line 3271 of file childpdo.cpp.

Referenced by BroadcastOpen(), and CreateRedirectedFile().

RemoveLock

WDF_REMOVE_LOCK_OPTIONS_INIT & RemoveLock

Definition at line 3268 of file childpdo.cpp.

Referenced by IoAcquireRemoveLockEx(), IoInitializeRemoveLockEx(), IoReleaseRemoveLockAndWaitEx(), IoReleaseRemoveLockEx(), Mx::MxAcquireRemoveLock(), Mx::MxReleaseRemoveLock(), and Mx::MxReleaseRemoveLockAndWait().

ResourcesRaw

_In_ WDFCMRESLIST ResourcesRaw

Definition at line 1183 of file childpdo.cpp.

ResourcesTranslated

_In_ WDFCMRESLIST ResourcesTranslated

Initial value:

{
    DECLARE_CONST_UNICODE_STRING(SymbolicName, L"SymbolicName")

Definition at line 1184 of file childpdo.cpp.

Status

Failed Port Status = Pdo->m_AcpiD3Cold.GetD3ColdCapability(Pdo->m_AcpiD3Cold.Context, D3ColdSupported)

Definition at line 561 of file childpdo.cpp.

Referenced by for(), HubInitInterfaceInformation(), HubPdoCachedDescriptor(), HubPdoCompleteAsIs(), HubPdoCompleteIrp(), HubPdoDispatchIoctl(), HubPdoEvtEnableWakeAtBus(), HubPdoIndicateWake(), HubPdoPowerIrpComplete(), HubPdoPreprocessSetPower(), HubPdoQueueAndWait(), HubPdoRouteUrb(), HubPdoSendWakeNotification(), and if().

STATUS_SUCCESS

return STATUS_SUCCESS

Definition at line 584 of file childpdo.cpp.

Referenced by HubNtStatusToUsbd(), HubPdoAnswerD3Cold(), HubPdoCachedDescriptor(), HubPdoCyclePort(), HubPdoDispatchIoctl(), HubPdoEvtEnableWakeAtBus(), HubPdoEvtParentInterfaceQuery(), HubPdoEvtQueryRemove(), HubPdoEvtQueryStop(), HubPdoEvtSelfManagedIoStart(), HubPdoEvtSelfManagedIoSuspend(), HubPdoGetHubName(), HubPdoIndicateWake(), HubPdoLpmSettingChanged(), HubPdoMsFeatureDescriptor(), HubPdoPreprocessInternalIoctl(), HubPdoPreprocessPnp(), HubPdoQueryCapability(), HubPdoRecordFailure(), HubPdoSendWakeNotification(), HubPdoTopologyAddress(), HubPdoValidateUrb(), HubUsbdStatusToNt(), and if().

SymbolicLinkName

_In_ PUNICODE_STRING SymbolicLinkName

Initial value:

{
    HubPdo* Pdo = (HubPdo*)Context

Definition at line 852 of file childpdo.cpp.

SystemPowerState

_In_ SYSTEM_POWER_STATE SystemPowerState

Definition at line 556 of file childpdo.cpp.

TargetState

_In_ WDF_POWER_DEVICE_STATE TargetState

Initial value:

{
    HubPdo* Pdo = HubGetPdoContext(Device)

Definition at line 1526 of file childpdo.cpp.

TRUE

return TRUE

Definition at line 3391 of file childpdo.cpp.

Referenced by HubFindSelectedInterface(), HubPdoForwardSelectLike(), HubPdoPreprocessInternalIoctl(), HubPdoPreprocessSetPower(), HubPdoQueryCapability(), and HubPdoQueueAndWait().

Version

Info Version = 1

Definition at line 2345 of file childpdo.cpp.

What

_In_ DsmEvent _In_ PCSTR What

Initial value:

{
    PAGED_CODE()

Definition at line 260 of file childpdo.cpp.

Referenced by CreateBase(), and PortReportChange().