#include <hubsm.h>

Inheritance diagram for HubMachine:

Collaboration diagram for HubMachine:

[legend]

Public Member Functions
VOID	Initialize (_In_ HubFdo *Hub, _In_ HubKind Kind)

HubFdo *	Hub () const

Public Member Functions inherited from SmMachine< HubMachine, HubEvent >
VOID	SmInitialize (_In_ const State *Initial)

BOOLEAN	SmPost (_In_ HubEvent Ev)

VOID	SmContinueOnPassive ()

const State *	SmCurrent () const

ULONG	SmDepth () const

const State *	SmFrame (_In_ ULONG Index) const

BOOLEAN	SmIsIn (_In_ const State *Ancestor) const

BOOLEAN	SmIsPaused () const

BOOLEAN	SmIsWaitingForTimer () const

ULONG	SmUnexpectedCount () const

Static Public Attributes
static const SM_EVENT_INFO	EventInfo []

Private Types
enum class	Teardown : UCHAR { Recover , Fatal , Stop , StopAfterReset , Suspend , ResumeFailed }

enum class	PowerUp : UCHAR { Start , PostReset , Resume , ResumeInS0 , ResumeWithReset , ResumeResetFailed }

enum class	DromPhase : UCHAR { Header , Full }

enum class	StatusRead : UCHAR { Change , LostChanges , OverCurrent }

Private Member Functions
VOID	SmReference ()

VOID	SmDereference ()

VOID	SmQueuePassive ()

SM_RESULT	OnAwaitingAddDevice (_In_ HubEvent Event)

SM_RESULT	OnUnconfigured (_In_ HubEvent Event)

SM_RESULT	OnQueryingParentInfo (_In_ HubEvent Event)

SM_RESULT	OnConfiguring (_In_ HubEvent Event)

SM_RESULT	OnReconfiguring (_In_ HubEvent Event)

SM_RESULT	OnDromRead (_In_ HubEvent Event)

SM_RESULT	OnDromReadingFirstStatus (_In_ HubEvent Event)

SM_RESULT	OnDromWritingMetadata (_In_ HubEvent Event)

SM_RESULT	OnDromSendingCommand (_In_ HubEvent Event)

SM_RESULT	OnDromReadingStatus (_In_ HubEvent Event)

SM_RESULT	OnDromReadingWord (_In_ HubEvent Event)

SM_RESULT	OnAwaitingD0 (_In_ HubEvent Event)

SM_RESULT	OnDown (_In_ HubEvent Event)

SM_RESULT	OnStopped (_In_ HubEvent Event)

SM_RESULT	OnAwaitingReleaseHardware (_In_ HubEvent Event)

SM_RESULT	OnAwaitingReleaseAfterFailure (_In_ HubEvent Event)

SM_RESULT	OnAwaitingStop (_In_ HubEvent Event)

SM_RESULT	OnSurpriseRemoved (_In_ HubEvent Event)

SM_RESULT	OnPortsAcquiring (_In_ HubEvent Event)

SM_RESULT	OnDevicesAcquiring (_In_ HubEvent Event)

SM_RESULT	OnListening (_In_ HubEvent Event)

SM_RESULT	OnNotListening (_In_ HubEvent Event)

SM_RESULT	OnReadingPortStatus (_In_ HubEvent Event)

SM_RESULT	OnReadingHubStatus (_In_ HubEvent Event)

SM_RESULT	OnAckingHubChange (_In_ HubEvent Event)

SM_RESULT	OnAwaitingOverCurrentTimer (_In_ HubEvent Event)

SM_RESULT	OnResettingPipe (_In_ HubEvent Event)

SM_RESULT	OnDrainingInterruptRefs (_In_ HubEvent Event)

SM_RESULT	OnCancelingInterrupt (_In_ HubEvent Event)

SM_RESULT	OnAwaitingInterruptRefs (_In_ HubEvent Event)

SM_RESULT	OnAwaitingInterruptEnable (_In_ HubEvent Event)

SM_RESULT	OnDevicesReleasing (_In_ HubEvent Event)

SM_RESULT	OnPortsReleasing (_In_ HubEvent Event)

SM_RESULT	OnPortsResetting (_In_ HubEvent Event)

SM_RESULT	OnHubResetting (_In_ HubEvent Event)

SM_RESULT	OnAwaitingResetRetry (_In_ HubEvent Event)

SM_RESULT	OnReconfiguringAfterReset (_In_ HubEvent Event)

SM_RESULT	OnResettingOnResume (_In_ HubEvent Event)

SM_RESULT	OnReconfiguringAfterResume (_In_ HubEvent Event)

SM_RESULT	OnCheckingPowerLoss (_In_ HubEvent Event)

SM_RESULT	OnAsleep (_In_ HubEvent Event)

SM_RESULT	OnSuspended (_In_ HubEvent Event)

SM_RESULT	OnRecycleSuspended (_In_ HubEvent Event)

SM_RESULT	OnSuspendedResetPending (_In_ HubEvent Event)

SM_RESULT	OnAwaitingStopAfterSuspend (_In_ HubEvent Event)

SM_RESULT	OnReadingHubDescriptor (_In_ HubEvent Event)

SM_RESULT	OnAwaitingDescriptorRetry (_In_ HubEvent Event)

SM_RESULT	OnReadingStandardStatus (_In_ HubEvent Event)

SM_RESULT	OnReadingConfigDescriptor (_In_ HubEvent Event)

SM_RESULT	OnUpdatingController (_In_ HubEvent Event)

SM_RESULT	OnSettingConfiguration (_In_ HubEvent Event)

SM_RESULT	OnFinishingConfiguration (_In_ HubEvent Event)

SM_RESULT	OnReadingRootHubInfo (_In_ HubEvent Event)

SM_RESULT	OnReadingRootHub20Ports (_In_ HubEvent Event)

SM_RESULT	OnReadingRootHub30Ports (_In_ HubEvent Event)

SM_RESULT	OnProgrammingHubDepth (_In_ HubEvent Event)

SM_RESULT	EnterQueryingParentInfo ()

SM_RESULT	EnterConfiguring ()

SM_RESULT	EnterReconfiguring ()

SM_RESULT	EnterDromReadingFirstStatus ()

SM_RESULT	EnterDromWritingMetadata ()

SM_RESULT	EnterDromSendingCommand ()

SM_RESULT	EnterDromReadingStatus ()

SM_RESULT	EnterDromReadingWord ()

SM_RESULT	EnterQueryingErrata ()

SM_RESULT	EnterSignalPnp ()

SM_RESULT	EnterCheckingRecoveryLimit ()

SM_RESULT	EnterReportingFailure ()

SM_RESULT	EnterHalted ()

SM_RESULT	EnterHubResetting ()

SM_RESULT	EnterLoggingReset ()

SM_RESULT	EnterReconfiguringAfterReset ()

SM_RESULT	EnterReconfiguringAfterResume ()

SM_RESULT	EnterSuspendedResetPending ()

SM_RESULT	EnterReadingHubDescriptor ()

SM_RESULT	EnterAwaitingDescriptorRetry ()

SM_RESULT	EnterReadingStandardStatus ()

SM_RESULT	EnterReadingConfigDescriptor ()

SM_RESULT	EnterUpdatingController ()

SM_RESULT	EnterSettingConfiguration ()

SM_RESULT	EnterFinishingConfiguration ()

SM_RESULT	EnterReadingRootHubInfo ()

SM_RESULT	EnterReadingRootHub20Ports ()

SM_RESULT	EnterReadingRootHub30Ports ()

SM_RESULT	EnterProgrammingHubDepth ()

SM_RESULT	StartHubConfiguration ()

SM_RESULT	FailStart (_In_ BOOLEAN FirstStart)
	A failed first start returns to Unconfigured, a failed restart to Stopped.

SM_RESULT	StartDromOrSkip (_In_ const State *Next)
	Reads the router DROM through the vendor mailbox; no failure here fails the start.

SM_RESULT	CheckDromStatus ()

SM_RESULT	StartDromWords ()
	The DWORD count is rounded up from the total size, not from the length field.

SM_RESULT	StoreDromWordAndContinue ()

SM_RESULT	FinishDrom ()

SM_RESULT	StartPowerUp (_In_ PowerUp Kind)

SM_RESULT	ReadStatus (_In_ StatusRead Purpose)

SM_RESULT	HandleHubChange (_In_ HubChange Change)
	None comes only from the lost change query, Error only from the pending one.

SM_RESULT	HandleHubStatusFault ()

SM_RESULT	OverCurrentError ()

SM_RESULT	SendInterrupt (_In_ BOOLEAN ClearPipeResets)

SM_RESULT	QuiesceWithInterrupt (_In_ Teardown Reason)

SM_RESULT	QuiesceWithoutInterrupt (_In_ Teardown Reason)

SM_RESULT	AfterInterruptQuiet ()

SM_RESULT	ReadPortStatus (_In_ const State *ReturnTo)

SM_RESULT	ResumeResetFailed ()

SM_RESULT	CheckPowerLoss ()

SM_RESULT	CallHubDepthOr (_In_ PowerUp Kind)

VOID	ReferenceHub ()

VOID	DereferenceHub ()

VOID	QueuePassiveWork ()

VOID	AcquirePowerReference ()

VOID	ReleasePowerReference ()

VOID	SignalPnpEvent ()

VOID	SignalPnpFailure ()

VOID	ReportFailureToPnp ()

VOID	BugcheckBootHub ()

VOID	LogResetRecovery ()

VOID	LogResetOnResume ()

VOID	QueryErrataFlags ()

VOID	CancelStatusChangeRead ()

VOID	StartStatusChangeRead ()

VOID	GetHubStatus ()

VOID	GetPortStatus ()

VOID	ReplyPortStatus ()

VOID	FailPortStatus (_In_ BOOLEAN HardwareError)

VOID	AckHubChange ()

VOID	GetHubDescriptor ()

VOID	GetStandardStatus ()

VOID	GetConfigDescriptor (_In_ BOOLEAN FullLength)

VOID	SetHubDepth ()

VOID	InitializeResetCount ()

VOID	ClearPipeResetCount ()

VOID	InitializeDescriptorRetries ()

VOID	ArmResetRetryTimer ()

VOID	ArmOverCurrentTimer ()

VOID	StartDescriptorRetryTimer ()

VOID	QueueSurpriseRemovalToPorts ()

VOID	QueueStopToPorts ()

VOID	QueueResetToPorts ()

VOID	QueueStartToPorts ()

VOID	QueueSuspendToPorts ()

VOID	QueueResumeToPorts ()

VOID	QueueResumeInS0ToPorts ()

VOID	QueueResumeWithResetToPorts ()

VOID	QueueFakeStatusChangeToPorts ()

VOID	QueueStatusChangeToPorts ()

VOID	AllowHubReset ()

VOID	QueueStopToDevices ()

VOID	QueueStopAfterSuspendToDevices ()

VOID	QueueSuspendToDevices ()

VOID	QueueStartToDevices ()

VOID	QueueResumeToDevices ()

VOID	QueueResumeInS0ToDevices ()

VOID	QueueResumeWithResetToDevices ()

VOID	ResetHub ()

VOID	ResetStatusChangePipe ()

VOID	SelectHubConfiguration ()

VOID	GetParentInfo ()

VOID	QueryControllerInfo ()

VOID	GetRootHubInfo ()

VOID	GetRootHub20Ports ()

VOID	GetRootHub30Ports ()

VOID	UpdateControllerHubInfo ()

VOID	ReadDromRegister (_In_ USHORT Register)

VOID	WriteDromRegister (_In_ USHORT Register, _In_ ULONG Value)

VOID	UseDromHeaderBuffer ()

VOID	ReleaseDromBuffer ()

VOID	StoreDromWord (_In_ ULONG Index)

VOID	ParseDromIdentity ()
	Finds the router identity entry of a version 1 DROM, bounds checking each entry.

BOOLEAN	IsDepthZero ()

BOOLEAN	IsInBootPath ()

BOOLEAN	WasResetByParent ()

BOOLEAN	RecoveryLimitReached ()

BOOLEAN	ResetLimitReached ()

BOOLEAN	PipeResetLimitReached ()

BOOLEAN	DescriptorRetriesExhausted ()

BOOLEAN	PortInterruptRefsReleased ()

BOOLEAN	OverCurrentCleared ()

BOOLEAN	CreateChildPorts ()

BOOLEAN	IsErrorFatal ()

HubCheck	CheckHubChangeBit ()

HubCheck	SelectHubChange ()

HubChange	PendingHubChange ()

HubChange	LostHubChange ()

BOOLEAN	ConfigDescriptorTruncated ()

BOOLEAN	ParseHubDescriptor ()

BOOLEAN	ParsePowerStatus ()

BOOLEAN	CacheConfigDescriptor ()

BOOLEAN	IsDromReadWanted ()

ULONG	MailboxValue ()

ULONG	DromDataLength ()

BOOLEAN	AllocateDromBuffer (_In_ ULONG Length)

Private Attributes
HubFdo *	m_Hub

HubKind	m_Kind

Teardown	m_Teardown

PowerUp	m_PowerUp

StatusRead	m_StatusRead

const State *	m_PortStatusReturn

BOOLEAN	m_ReleaseToUnconfigured

BOOLEAN	m_FullConfigRead

ULONGLONG	m_DromPollStart

ULONG	m_DromIndex

ULONG	m_DromWords

DromPhase	m_DromPhase

const State *	m_DromNext

Static Private Attributes
static const BOOLEAN	SmCompletionsFirst = FALSE

static const State	AwaitingAddDevice

static const State	Unconfigured

static const State	QueryingParentInfo

static const State	Configuring

static const State	Reconfiguring

static const State	DromRead

static const State	DromReadingFirstStatus

static const State	DromWritingMetadata

static const State	DromSendingCommand

static const State	DromReadingStatus

static const State	DromReadingWord

static const State	QueryingErrata

static const State	AwaitingD0

static const State	Down

static const State	Stopped

static const State	AwaitingReleaseHardware

static const State	AwaitingReleaseAfterFailure

static const State	AwaitingStop

static const State	SurpriseRemoved

static const State	Deleted

static const State	PortsAcquiring

static const State	DevicesAcquiring

static const State	Listening

static const State	NotListening

static const State	ReadingPortStatus

static const State	ReadingHubStatus

static const State	AckingHubChange

static const State	AwaitingOverCurrentTimer

static const State	ResettingPipe

static const State	DrainingInterruptRefs

static const State	CancelingInterrupt

static const State	AwaitingInterruptRefs

static const State	AwaitingInterruptEnable

static const State	DevicesReleasing

static const State	PortsReleasing

static const State	PortsResetting

static const State	CheckingRecoveryLimit

static const State	ReportingFailure

static const State	Halted

static const State	HubResetting

static const State	LoggingReset

static const State	AwaitingResetRetry

static const State	ReconfiguringAfterReset

static const State	ResettingOnResume

static const State	ReconfiguringAfterResume

static const State	CheckingPowerLoss

static const State	Asleep

static const State	Suspended

static const State	RecycleSuspended

static const State	SuspendedResetPending

static const State	AwaitingStopAfterSuspend

static const State	ReadingHubDescriptor

static const State	AwaitingDescriptorRetry

static const State	ReadingStandardStatus

static const State	ReadingConfigDescriptor

static const State	UpdatingController

static const State	SettingConfiguration

static const State	FinishingConfiguration

static const State	ReadingRootHubInfo

static const State	ReadingRootHub20Ports

static const State	ReadingRootHub30Ports

static const State	ProgrammingHubDepth

static const HubEvent	ResetDiscards [] = { HubEvent::ResetRequested, HubEvent::Count }

Friends
class	SmMachine< HubMachine, HubEvent >

Additional Inherited Members
Public Types inherited from SmMachine< HubMachine, HubEvent >
typedef SmState< HubMachine, HubEvent >	State

Protected Member Functions inherited from SmMachine< HubMachine, HubEvent >
VOID	SmBeginPause ()

VOID	SmDiscardQueued (_In_ HubEvent Ev)

BOOLEAN	SmAccepts (_In_ HubEvent Ev)

VOID	SmReference ()

VOID	SmDereference ()

VOID	SmQueuePassive ()

VOID	SmOnDequeue (_In_ HubEvent Ev)

VOID	SmStateChanged ()

BOOLEAN	SmCancelTimer ()

Static Protected Member Functions inherited from SmMachine< HubMachine, HubEvent >
static SM_RESULT	SmMakeResult (_In_ SM_RESULT_KIND Kind, _In_ USHORT Ev, _In_opt_ const VOID *Target)

static SM_RESULT	SmHandled ()

static SM_RESULT	SmUnhandled ()

static SM_RESULT	SmTransition (_In_ const State *Target)

static SM_RESULT	SmPaused ()

static SM_RESULT	SmCall (_In_ const State *Start)

static SM_RESULT	SmReturn (_In_ HubEvent Ev)

Static Protected Attributes inherited from SmMachine< HubMachine, HubEvent >
static const BOOLEAN	SmCompletionsFirst

static const USHORT	SmTimerEventId

Detailed Description

Definition at line 89 of file hubsm.h.

Member Enumeration Documentation

◆ DromPhase

enum class HubMachine::DromPhase : UCHAR

strongprivate

Which part of the router DROM the mailbox read is fetching

Enumerator
Header
Full

Definition at line 131 of file hubsm.h.

    {
        Header,
        Full
    };

◆ PowerUp

enum class HubMachine::PowerUp : UCHAR

strongprivate

Why the port and device references are being taken

Enumerator
Start
PostReset
Resume
ResumeInS0
ResumeWithReset
ResumeResetFailed

Definition at line 120 of file hubsm.h.

    {
        Start,
        PostReset,
        Resume,
        ResumeInS0,
        ResumeWithReset,
        ResumeResetFailed
    };

◆ StatusRead

enum class HubMachine::StatusRead : UCHAR

strongprivate

What a hub status read is for

Enumerator
Change
LostChanges
OverCurrent

Definition at line 138 of file hubsm.h.

    {
        Change,
        LostChanges,
        OverCurrent
    };

◆ Teardown

enum class HubMachine::Teardown : UCHAR

strongprivate

Why the hub is being taken down

Enumerator
Recover
Fatal
Stop
StopAfterReset
Suspend
ResumeFailed

Definition at line 109 of file hubsm.h.

    {
        Recover,
        Fatal,
        Stop,
        StopAfterReset,
        Suspend,
        ResumeFailed
    };

Member Function Documentation

◆ AckHubChange()

VOID HubMachine::AckHubChange ( )

private

Definition at line 348 of file hubreq.cpp.

{
    m_Hub->m_Control.SetSetup(0x20, HUB_REQUEST_CLEAR_FEATURE, m_Hub->m_SelectedFeature, 0, 0);
    DPRINT("Hub %p acking hub change %u\n", m_Hub, m_Hub->m_SelectedFeature);
    HubSendControl(m_Hub, NULL, 0, FALSE);
}

Referenced by OnReadingHubStatus().

◆ AcquirePowerReference()

VOID HubMachine::AcquirePowerReference ( )

private

Definition at line 1210 of file fdo.cpp.

{
    m_Hub->AcquirePowerReference();
}

Referenced by EnterSuspendedResetPending(), OnAwaitingD0(), OnListening(), OnRecycleSuspended(), and OnSuspended().

◆ AfterInterruptQuiet()

SM_RESULT HubMachine::AfterInterruptQuiet ( )

private

Definition at line 1153 of file hubsm.cpp.

{
    switch (m_Teardown)
    {
        case Teardown::Stop:
            QueueStopToDevices();
            return SmTransition(&DevicesReleasing);
 
        case Teardown::Suspend:
            QueueSuspendToDevices();
            return SmTransition(&DevicesReleasing);
 
        default:
            QueueStopToPorts();
            return SmTransition(&PortsReleasing);
    }
}

Referenced by OnAwaitingInterruptRefs(), OnCancelingInterrupt(), and QuiesceWithoutInterrupt().

◆ AllocateDromBuffer()

BOOLEAN HubMachine::AllocateDromBuffer ( _In_ ULONG Length )

private

Definition at line 158 of file hubdrom.cpp.

{
    ULONG Bytes = ALIGN_UP_BY(Length, sizeof(ULONG));
    PULONG Buffer;
 
    Buffer = (PULONG)ExAllocatePoolZero(NonPagedPool, Bytes, HUB_TAG_HUB);
    if (Buffer == NULL)
    {
        DPRINT1("Hub %p no memory for a %lu byte router DROM\n", m_Hub, Length);
        return FALSE;
    }
 
    m_Hub->m_DromPool = Buffer;
    m_Hub->m_DromBuffer = Buffer;
    m_Hub->m_DromLength = Length;
    return TRUE;
}

Referenced by StartDromWords().

◆ AllowHubReset()

VOID HubMachine::AllowHubReset ( )

private

Definition at line 865 of file fanout.cpp.

{
    m_Hub->AllowHubReset();
}

Referenced by StartPowerUp().

◆ ArmOverCurrentTimer()

VOID HubMachine::ArmOverCurrentTimer ( )

private

Definition at line 1324 of file fdo.cpp.

{
    m_Hub->m_Timer.Start(HUB_OVERCURRENT_TIME);
}

Referenced by HandleHubChange().

◆ ArmResetRetryTimer()

VOID HubMachine::ArmResetRetryTimer ( )

private

Definition at line 1318 of file fdo.cpp.

{
    m_Hub->m_Timer.Start(HUB_RESET_RETRY_TIME);
}

Referenced by EnterLoggingReset(), and OnHubResetting().

◆ BugcheckBootHub()

VOID HubMachine::BugcheckBootHub ( )

private

Definition at line 1253 of file fdo.cpp.

{
    DPRINT1("Boot path hub %p failed, bugchecking\n", m_Hub->m_Device);
 
    KeBugCheckEx(HUB_BUGCHECK_USB3,
                 HUB_USB3_BOOT_DEVICE_FAILED,
                 (ULONG_PTR)WdfDeviceWdmGetDeviceObject(m_Hub->m_Device),
                 HUB_BOOT_DEVICE_IS_HUB,
                 0);
}

Referenced by EnterHalted().

◆ CacheConfigDescriptor()

BOOLEAN HubMachine::CacheConfigDescriptor ( )

private

Definition at line 489 of file hubreq.cpp.

{
    PUSB_CONFIGURATION_DESCRIPTOR Held = m_Hub->m_ConfigDescriptor;
    PUSB_CONFIGURATION_DESCRIPTOR Copy = NULL;
    USHORT TotalLength = Held->wTotalLength;
    BOOLEAN Valid = FALSE;
 
    if (m_Hub->m_Control.Urb.TransferBufferLength < sizeof(*Held) || TotalLength < sizeof(*Held))
    {
        DPRINT1("Hub %p configuration descriptor too short, %lu bytes, wTotalLength %u\n",
                m_Hub, m_Hub->m_Control.Urb.TransferBufferLength, TotalLength);
        goto Exit;
    }
 
    /* The buffer was sized from the first read, so a larger second wTotalLength is rejected */
    if (TotalLength > m_Hub->m_ConfigTotalLength)
    {
        HubLogConfigTotalLengthMismatch(m_Hub);
        goto Exit;
    }
 
    if (TotalLength < MAXUCHAR)
    {
        Copy = (PUSB_CONFIGURATION_DESCRIPTOR)ExAllocatePoolWithTag(NonPagedPool, TotalLength, HUB_TAG_HUB);
        if (Copy == NULL)
        {
            DPRINT1("Hub %p no memory to cache the configuration descriptor\n", m_Hub);
            goto Exit;
        }
 
        RtlCopyMemory(Copy, Held, TotalLength);
        m_Hub->m_ConfigDescriptor = Copy;
    }
 
    if (!HubValidateHubConfiguration(m_Hub, m_Hub->m_ConfigDescriptor, TotalLength))
        goto Exit;
 
    if (TotalLength != m_Hub->m_ConfigTotalLength)
    {
        HubLogConfigTotalLengthMismatch(m_Hub);
        goto Exit;
    }
 
    Valid = TRUE;
 
Exit:
    if (Copy != NULL)
        ExFreePoolWithTag(Held, HUB_TAG_HUB);
 
    if (!Valid && m_Hub->m_ConfigDescriptor != NULL)
    {
        ExFreePoolWithTag(m_Hub->m_ConfigDescriptor, HUB_TAG_HUB);
        m_Hub->m_ConfigDescriptor = NULL;
    }
 
    return Valid;
}

Referenced by OnReadingConfigDescriptor().

◆ CallHubDepthOr()

SM_RESULT HubMachine::CallHubDepthOr ( _In_ PowerUp Kind )

private

Definition at line 1379 of file hubsm.cpp.

{
    if (m_Kind == HubKind::Usb30)
        return SmCall(&ProgrammingHubDepth);
 
    return StartPowerUp(Kind);
}

Referenced by EnterReconfiguringAfterReset(), and EnterReconfiguringAfterResume().

◆ CancelStatusChangeRead()

VOID HubMachine::CancelStatusChangeRead ( )

private

Definition at line 757 of file hubreq.cpp.

{
    if (!WdfRequestCancelSentRequest(m_Hub->m_Interrupt.Request))
        DPRINT1("Hub %p status change read not canceled\n", m_Hub);
}

Referenced by OnDrainingInterruptRefs(), and QuiesceWithInterrupt().

◆ CheckDromStatus()

SM_RESULT HubMachine::CheckDromStatus ( )

private

Definition at line 583 of file hubsm.cpp.

{
    if (!(MailboxValue() & HubMailboxBusy))
        return SmTransition(&DromReadingWord);
 
    if (KeQueryInterruptTime() - m_DromPollStart <= HubDromBusyLimit)
        return SmTransition(&DromReadingStatus);
 
    DPRINT1("Hub %p router still busy after 5 s, DROM read stopped at DWORD %lu\n", m_Hub, m_DromIndex);
    return FinishDrom();
}

Referenced by OnDromReadingStatus().

◆ CheckHubChangeBit()

HubCheck HubMachine::CheckHubChangeBit ( )

private

Definition at line 765 of file hubreq.cpp.

{
    HubInterruptRequest* Interrupt = &m_Hub->m_Interrupt;
    HubCheck Result = (Interrupt->BitmapBuffer[0] & 1) ? HubCheck::Yes : HubCheck::No;
    ULONG Bit;
 
    for (Bit = 1; Bit < (ULONG)Interrupt->BitmapBytes * 8; Bit++)
    {
        if (!(Interrupt->BitmapBuffer[Bit / 8] & (1 << (Bit % 8))))
            continue;
 
        if (m_Hub->FindPort(Bit) == NULL)
        {
            DPRINT1("Hub %p reports a change on missing port %lu\n", m_Hub, Bit);
            return HubCheck::Error;
        }
    }
 
    return Result;
}

Referenced by OnListening().

◆ CheckPowerLoss()

SM_RESULT HubMachine::CheckPowerLoss ( )

private

Definition at line 1464 of file hubsm.cpp.

{
    if (m_Kind == HubKind::Root)
        return StartPowerUp(PowerUp::Resume);
 
    GetHubDescriptor();
    return SmTransition(&CheckingPowerLoss);
}

Referenced by OnSuspended().

◆ ClearPipeResetCount()

VOID HubMachine::ClearPipeResetCount ( )

private

Definition at line 1344 of file fdo.cpp.

{
    m_Hub->m_ResetCount = 0;
}

Referenced by SendInterrupt().

◆ ConfigDescriptorTruncated()

BOOLEAN HubMachine::ConfigDescriptorTruncated ( )

private

Definition at line 478 of file hubreq.cpp.

{
    m_Hub->m_ConfigTotalLength = m_Hub->m_ConfigDescriptor->wTotalLength;
    return m_Hub->m_ConfigTotalLength > MAXUCHAR;
}

Referenced by OnReadingConfigDescriptor().

◆ CreateChildPorts()

BOOLEAN HubMachine::CreateChildPorts ( )

private

Definition at line 853 of file fanout.cpp.

{
    return m_Hub->CreateChildPorts();
}

Referenced by EnterQueryingErrata().

◆ DereferenceHub()

VOID HubMachine::DereferenceHub ( )

private

Definition at line 1196 of file fdo.cpp.

{
    WdfObjectDereference(m_Hub->m_Device);
}

Referenced by SmDereference().

◆ DescriptorRetriesExhausted()

BOOLEAN HubMachine::DescriptorRetriesExhausted ( )

private

Definition at line 1380 of file fdo.cpp.

{
    if (m_Hub->m_DescriptorRetryCount++ <= HUB_RESET_LIMIT)
        return FALSE;
 
    DPRINT1("Hub %p hub descriptor retries exhausted\n", m_Hub->m_Device);
    return TRUE;
}

Referenced by OnReadingHubDescriptor().

◆ DromDataLength()

ULONG HubMachine::DromDataLength ( )

private

Definition at line 126 of file hubdrom.cpp.

{
    const UCHAR* Header = (const UCHAR*)m_Hub->m_DromHeader;
 
    return HubDromReadUshort(&Header[DROM_LENGTH_OFFSET]) & DROM_LENGTH_MASK;
}

Referenced by StartDromWords().

◆ EnterAwaitingDescriptorRetry()

SM_RESULT HubMachine::EnterAwaitingDescriptorRetry ( )

private

Definition at line 1617 of file hubsm.cpp.

{
    StartDescriptorRetryTimer();
    return SmHandled();
}

◆ EnterCheckingRecoveryLimit()

SM_RESULT HubMachine::EnterCheckingRecoveryLimit ( )

private

Definition at line 1287 of file hubsm.cpp.

{
    if (!RecoveryLimitReached())
    {
        InitializeResetCount();
        return SmTransition(&HubResetting);
    }
 
    if (IsInBootPath())
        return SmTransition(&Halted);
 
    return SmTransition(&ReportingFailure);
}

◆ EnterConfiguring()

SM_RESULT HubMachine::EnterConfiguring ( )

private

Definition at line 351 of file hubsm.cpp.

{
    QueryControllerInfo();
 
    if (m_Kind == HubKind::Root)
        return SmCall(&ReadingRootHubInfo);
 
    return StartHubConfiguration();
}

◆ EnterDromReadingFirstStatus()

SM_RESULT HubMachine::EnterDromReadingFirstStatus ( )

private

Definition at line 501 of file hubsm.cpp.

{
    ReadDromRegister(HubMailboxOpcode);
    return SmHandled();
}

◆ EnterDromReadingStatus()

SM_RESULT HubMachine::EnterDromReadingStatus ( )

private

Definition at line 565 of file hubsm.cpp.

{
    ReadDromRegister(HubMailboxOpcode);
    return SmHandled();
}

◆ EnterDromReadingWord()

SM_RESULT HubMachine::EnterDromReadingWord ( )

private

Definition at line 622 of file hubsm.cpp.

{
    ReadDromRegister(static_cast<USHORT>(m_DromIndex % HubMailboxDataWords));
    return SmHandled();
}

◆ EnterDromSendingCommand()

SM_RESULT HubMachine::EnterDromSendingCommand ( )

private

Definition at line 547 of file hubsm.cpp.

{
    WriteDromRegister(HubMailboxOpcode, HubDromReadCommand);
    return SmHandled();
}

◆ EnterDromWritingMetadata()

SM_RESULT HubMachine::EnterDromWritingMetadata ( )

private

Definition at line 527 of file hubsm.cpp.

{
    ULONG Count = min(HubMailboxDataWords, m_DromWords - m_DromIndex);
    ULONG Metadata = ((m_DromIndex & 0x1FFF) << 2) | ((Count & 0x1F) << 15);
 
    WriteDromRegister(HubMailboxMetadata, Metadata);
    return SmHandled();
}

◆ EnterFinishingConfiguration()

SM_RESULT HubMachine::EnterFinishingConfiguration ( )

private

Definition at line 1747 of file hubsm.cpp.

{
    return SmCall(&ProgrammingHubDepth);
}

◆ EnterHalted()

SM_RESULT HubMachine::EnterHalted ( )

private

Definition at line 1309 of file hubsm.cpp.

{
    BugcheckBootHub();
    return SmHandled();
}

◆ EnterHubResetting()

SM_RESULT HubMachine::EnterHubResetting ( )

private

Definition at line 1318 of file hubsm.cpp.

{
    ResetHub();
    return SmHandled();
}

◆ EnterLoggingReset()

SM_RESULT HubMachine::EnterLoggingReset ( )

private

Definition at line 1346 of file hubsm.cpp.

{
    LogResetRecovery();
    ArmResetRetryTimer();
    return SmTransition(&AwaitingResetRetry);
}

◆ EnterProgrammingHubDepth()

SM_RESULT HubMachine::EnterProgrammingHubDepth ( )

private

Definition at line 1840 of file hubsm.cpp.

{
    SetHubDepth();
    return SmHandled();
}

◆ EnterQueryingErrata()

SM_RESULT HubMachine::EnterQueryingErrata ( )

private

Definition at line 426 of file hubsm.cpp.

{
    QueryErrataFlags();
 
    if (!CreateChildPorts())
        return FailStart(TRUE);
 
    return SmTransition(&AwaitingD0);
}

◆ EnterQueryingParentInfo()

SM_RESULT HubMachine::EnterQueryingParentInfo ( )

private

Definition at line 327 of file hubsm.cpp.

{
    GetParentInfo();
    return SmHandled();
}

◆ EnterReadingConfigDescriptor()

SM_RESULT HubMachine::EnterReadingConfigDescriptor ( )

private

Definition at line 1662 of file hubsm.cpp.

{
    GetConfigDescriptor(m_FullConfigRead);
    return SmHandled();
}

◆ EnterReadingHubDescriptor()

SM_RESULT HubMachine::EnterReadingHubDescriptor ( )

private

Definition at line 1587 of file hubsm.cpp.

{
    GetHubDescriptor();
    return SmHandled();
}

◆ EnterReadingRootHub20Ports()

SM_RESULT HubMachine::EnterReadingRootHub20Ports ( )

private

Definition at line 1790 of file hubsm.cpp.

{
    GetRootHub20Ports();
    return SmHandled();
}

◆ EnterReadingRootHub30Ports()

SM_RESULT HubMachine::EnterReadingRootHub30Ports ( )

private

Definition at line 1814 of file hubsm.cpp.

{
    GetRootHub30Ports();
    return SmHandled();
}

◆ EnterReadingRootHubInfo()

SM_RESULT HubMachine::EnterReadingRootHubInfo ( )

private

Definition at line 1765 of file hubsm.cpp.

{
    QueryControllerInfo();
    GetRootHubInfo();
    return SmHandled();
}

◆ EnterReadingStandardStatus()

SM_RESULT HubMachine::EnterReadingStandardStatus ( )

private

Definition at line 1634 of file hubsm.cpp.

{
    GetStandardStatus();
    return SmHandled();
}

◆ EnterReconfiguring()

SM_RESULT HubMachine::EnterReconfiguring ( )

private

Definition at line 379 of file hubsm.cpp.

{
    if (m_Kind == HubKind::Root)
        return SmTransition(&AwaitingD0);
 
    return StartHubConfiguration();
}

◆ EnterReconfiguringAfterReset()

SM_RESULT HubMachine::EnterReconfiguringAfterReset ( )

private

Definition at line 1389 of file hubsm.cpp.

{
    LogResetRecovery();
    return CallHubDepthOr(PowerUp::PostReset);
}

◆ EnterReconfiguringAfterResume()

SM_RESULT HubMachine::EnterReconfiguringAfterResume ( )

private

Definition at line 1440 of file hubsm.cpp.

{
    return CallHubDepthOr(PowerUp::ResumeWithReset);
}

◆ EnterReportingFailure()

SM_RESULT HubMachine::EnterReportingFailure ( )

private

Definition at line 1302 of file hubsm.cpp.

{
    ReportFailureToPnp();
    return SmTransition(&AwaitingStop);
}

◆ EnterSettingConfiguration()

SM_RESULT HubMachine::EnterSettingConfiguration ( )

private

Definition at line 1720 of file hubsm.cpp.

{
    SelectHubConfiguration();
    return SmHandled();
}

◆ EnterSignalPnp()

SM_RESULT HubMachine::EnterSignalPnp ( )

private

Definition at line 437 of file hubsm.cpp.

{
    SignalPnpEvent();
    return SmHandled();
}

◆ EnterSuspendedResetPending()

SM_RESULT HubMachine::EnterSuspendedResetPending ( )

private

Definition at line 1556 of file hubsm.cpp.

{
    AcquirePowerReference();
    return SmHandled();
}

◆ EnterUpdatingController()

SM_RESULT HubMachine::EnterUpdatingController ( )

private

Definition at line 1696 of file hubsm.cpp.

{
    UpdateControllerHubInfo();
    return SmHandled();
}

◆ FailPortStatus()

VOID HubMachine::FailPortStatus ( _In_ BOOLEAN HardwareError )

private

Definition at line 884 of file hubreq.cpp.

{
    WDF_REQUEST_PARAMETERS Params;
    WDFREQUEST Request = HubTakePortStatusRequest(m_Hub, &Params);
 
    if (Params.Parameters.DeviceIoControl.IoControlCode == IOCTL_INTERNAL_USB_GET_PORT_STATUS)
        *(PULONG)Params.Parameters.Others.Arg1 = 0;
 
    DPRINT1("Hub %p port %u status request failed, hardware error %u\n",
            m_Hub, m_Hub->m_PortStatusTarget->Number(), HardwareError);
 
    WdfRequestComplete(Request, HardwareError ? STATUS_ADAPTER_HARDWARE_ERROR : STATUS_NO_SUCH_DEVICE);
}

Referenced by OnAsleep(), OnAwaitingD0(), OnAwaitingResetRetry(), OnDown(), and OnReadingPortStatus().

◆ FailStart()

SM_RESULT HubMachine::FailStart ( _In_ BOOLEAN FirstStart )

private

A failed first start returns to Unconfigured, a failed restart to Stopped.

Definition at line 417 of file hubsm.cpp.

{
    SignalPnpFailure();
    m_ReleaseToUnconfigured = FirstStart;
    return SmTransition(&AwaitingReleaseAfterFailure);
}

Referenced by EnterQueryingErrata(), OnConfiguring(), OnQueryingParentInfo(), and OnReconfiguring().

◆ FinishDrom()

SM_RESULT HubMachine::FinishDrom ( )

private

Definition at line 659 of file hubsm.cpp.

{
    if (m_DromPhase == DromPhase::Full && m_DromIndex >= m_DromWords)
        ParseDromIdentity();
 
    ReleaseDromBuffer();
    m_DromPhase = DromPhase::Header;
    m_DromIndex = 0;
    m_DromWords = 0;
    return SmTransition(m_DromNext);
}

Referenced by CheckDromStatus(), OnDromRead(), StartDromWords(), and StoreDromWordAndContinue().

◆ GetConfigDescriptor()

VOID HubMachine::GetConfigDescriptor ( _In_ BOOLEAN FullLength )

private

Definition at line 417 of file hubreq.cpp.

{
    PUSB_CONFIGURATION_DESCRIPTOR Previous = m_Hub->m_ConfigDescriptor;
    PUSB_CONFIGURATION_DESCRIPTOR Buffer;
    ULONG Length;
    NTSTATUS Status;
 
    if (!FullLength)
    {
        if (Previous != NULL)
            ExFreePoolWithTag(Previous, HUB_TAG_HUB);
        Previous = NULL;
        Length = MAXUCHAR;
    }
    else
    {
        Length = Previous->wTotalLength;
    }
 
    m_Hub->m_ConfigDescriptor = NULL;
 
    Buffer = (PUSB_CONFIGURATION_DESCRIPTOR)ExAllocatePoolZero(NonPagedPool, Length, HUB_TAG_HUB);
    if (Buffer == NULL)
    {
        DPRINT1("Hub %p no memory for a %lu byte configuration descriptor\n", m_Hub, Length);
        Status = STATUS_INSUFFICIENT_RESOURCES;
    }
    else
    {
        DPRINT("Hub %p reading %lu bytes of configuration descriptor\n", m_Hub, Length);
        m_Hub->m_ConfigDescriptor = Buffer;
 
        m_Hub->m_Control.SetSetup(0x80, USB_REQUEST_GET_DESCRIPTOR, USB_CONFIGURATION_DESCRIPTOR_TYPE << 8, 0, (USHORT)Length);
        Status = m_Hub->m_Control.Send(m_Hub->m_RootHubTarget,
                                       m_Hub->UsbDevice(),
                                       HubControlComplete,
                                       m_Hub,
                                       Buffer,
                                       Length,
                                       TRUE,
                                       m_Hub->NeedsForwardProgress());
    }
 
    if (Previous != NULL)
        ExFreePoolWithTag(Previous, HUB_TAG_HUB);
 
    if (NT_SUCCESS(Status))
        return;
 
    if (m_Hub->m_ConfigDescriptor != NULL)
    {
        ExFreePoolWithTag(m_Hub->m_ConfigDescriptor, HUB_TAG_HUB);
        m_Hub->m_ConfigDescriptor = NULL;
    }
 
    m_Hub->Post(HubEvent::TransferFailed);
}

Referenced by EnterReadingConfigDescriptor().

◆ GetHubDescriptor()

VOID HubMachine::GetHubDescriptor ( )

private

Definition at line 357 of file hubreq.cpp.

{
    switch (m_Hub->m_Parent.HubSpeed)
    {
        case UsbFullSpeed:
        case UsbHighSpeed:
            m_Hub->m_Control.SetSetup(0xA0,
                                      HUB_REQUEST_GET_DESCRIPTOR,
                                      USB_20_HUB_DESCRIPTOR_TYPE << 8,
                                      0,
                                      sizeof(m_Hub->m_HubDescriptor.Usb20));
            HubSendControl(m_Hub, &m_Hub->m_HubDescriptor, sizeof(m_Hub->m_HubDescriptor.Usb20), TRUE);
            break;
 
        case UsbSuperSpeed:
            m_Hub->m_Control.SetSetup(0xA0,
                                      HUB_REQUEST_GET_DESCRIPTOR,
                                      USB_30_HUB_DESCRIPTOR_TYPE << 8,
                                      0,
                                      sizeof(m_Hub->m_HubDescriptor.Usb30));
            HubSendControl(m_Hub, &m_Hub->m_HubDescriptor, sizeof(m_Hub->m_HubDescriptor.Usb30), TRUE);
            break;
 
        default:
            DPRINT1("Hub %p of speed %lu has no hub descriptor\n", m_Hub, (ULONG)m_Hub->m_Parent.HubSpeed);
            m_Hub->Post(HubEvent::TransferFailed);
            break;
    }
}

Referenced by CheckPowerLoss(), and EnterReadingHubDescriptor().

◆ GetHubStatus()

VOID HubMachine::GetHubStatus ( )

private

Definition at line 397 of file hubreq.cpp.

{
    m_Hub->m_PreviousHubStatus = m_Hub->m_HubStatus;
 
    m_Hub->m_Control.SetSetup(0xA0, HUB_REQUEST_GET_STATUS, 0, 0, sizeof(m_Hub->m_HubStatus));
    DPRINT("Hub %p reading hub status\n", m_Hub);
    HubSendControl(m_Hub, &m_Hub->m_HubStatus, sizeof(m_Hub->m_HubStatus), FALSE);
}

Referenced by ReadStatus().

◆ GetParentInfo()

VOID HubMachine::GetParentInfo ( )

private

Definition at line 378 of file upstream.cpp.

{
    WDFREQUEST Request;
 
    if (!NT_SUCCESS(HubCreateParentRequest(m_Hub, &Request)))
    {
        m_Hub->Post(HubEvent::IoctlFailed);
        return;
    }
 
    if (!HubSendToParent(m_Hub, Request, IOCTL_UCXHUB_GET_HUB_INFO, &m_Hub->m_ParentInfo, HubParentInfoComplete, m_Hub))
    {
        WdfObjectDelete(Request);
        m_Hub->Post(HubEvent::IoctlFailed);
    }
}

Referenced by EnterQueryingParentInfo().

◆ GetPortStatus()

VOID HubMachine::GetPortStatus ( )

private

Definition at line 790 of file hubreq.cpp.

{
    HubPort* Port = m_Hub->m_PortStatusTarget;
    BOOLEAN Extended = Port->HasProperty(PortProperty::EnhancedSuperSpeed);
    USHORT Length = Extended ? sizeof(Port->m_Current) : sizeof(Port->m_Current.StatusChange);
 
    m_Hub->m_Control.SetSetup(0xA3, HUB_REQUEST_GET_STATUS, Extended ? 2 : 0, Port->Number(), Length);
    HubSendControl(m_Hub, &Port->m_Current, Length, FALSE);
}

Referenced by ReadPortStatus().

◆ GetRootHub20Ports()

VOID HubMachine::GetRootHub20Ports ( )

private

Definition at line 212 of file ucxlink.cpp.

{
    ULONG Count = m_Hub->m_RootHubInfo.Info.NumberOf20Ports;
    WDFIOTARGET Target = WdfDeviceGetIoTarget(m_Hub->m_Device);
    WDF_OBJECT_ATTRIBUTES Attributes;
    PROOTHUB_20PORTS_INFO Payload;
    PROOTHUB_20PORT_INFO Entries;
    WDFMEMORY Block = NULL;
    WDFMEMORY PayloadMemory;
    WDFREQUEST Request;
    PVOID Buffer;
    ULONG Index;
 
    if (Count == 0)
    {
        m_Hub->m_Root20Ports = NULL;
        m_Hub->Post(HubEvent::IoctlDone);
        return;
    }
 
    if (!NT_SUCCESS(HubCreateUcxRequest(m_Hub, Target, &Request)))
    {
        m_Hub->Post(HubEvent::IoctlFailed);
        return;
    }
 
    WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
    Attributes.ParentObject = m_Hub->m_Device;
 
    if (!NT_SUCCESS(WdfMemoryCreate(&Attributes,
                                    NonPagedPool,
                                    HUB_TAG_PORT,
                                    Count * (sizeof(ROOTHUB_20PORT_INFO) + sizeof(PVOID)),
                                    &Block,
                                    &Buffer)))
    {
        DPRINT1("Hub %p no memory for %lu root 2.0 ports\n", m_Hub, Count);
        goto Failed;
    }
 
    m_Hub->m_Root20Ports = (PROOTHUB_20PORT_INFO*)Buffer;
    Entries = (PROOTHUB_20PORT_INFO)(m_Hub->m_Root20Ports + Count);
 
    for (Index = 0; Index < Count; Index++)
    {
        m_Hub->m_Root20Ports[Index] = &Entries[Index];
        Entries[Index].MinorRevision = 0;
        Entries[Index].HubDepth = 0;
    }
 
    WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
    Attributes.ParentObject = Request;
 
    if (!NT_SUCCESS(WdfMemoryCreate(&Attributes,
                                    NonPagedPool,
                                    HUB_TAG_PORT,
                                    sizeof(*Payload),
                                    &PayloadMemory,
                                    (PVOID*)&Payload)))
    {
        DPRINT1("Hub %p no memory for the 2.0 port info request\n", m_Hub);
        goto Failed;
    }
 
    Payload->Size = sizeof(*Payload);
    Payload->NumberOfPorts = (USHORT)Count;
    Payload->PortInfoSize = sizeof(*Entries);
    Payload->PortInfoArray = m_Hub->m_Root20Ports;
 
    HubSendUcxIoctl(m_Hub, Target, IOCTL_UCXHUB_ROOTHUB_GET_20PORT_INFO, Payload, Request, HubRoot20PortsComplete);
    return;
 
Failed:
    WdfObjectDelete(Request);
    if (Block != NULL)
    {
        WdfObjectDelete(Block);
        m_Hub->m_Root20Ports = NULL;
    }
    m_Hub->Post(HubEvent::IoctlFailed);
}

Referenced by EnterReadingRootHub20Ports().

◆ GetRootHub30Ports()

VOID HubMachine::GetRootHub30Ports ( )

private

Definition at line 296 of file ucxlink.cpp.

{
    ULONG Count = m_Hub->m_RootHubInfo.Info.NumberOf30Ports;
    WDFIOTARGET Target = WdfDeviceGetIoTarget(m_Hub->m_Device);
    WDF_OBJECT_ATTRIBUTES Attributes;
    PROOTHUB_30PORTS_INFO Payload;
    PROOTHUB_30PORT_INFO_EX Entries;
    PUSB_DEVICE_CAPABILITY_SUPERSPEEDPLUS_SPEED Speeds;
    WDFMEMORY Block = NULL;
    WDFMEMORY PayloadMemory;
    WDFREQUEST Request;
    PVOID Buffer;
    ULONG Index;
 
    if (Count == 0)
    {
        m_Hub->m_Root30Ports = NULL;
        m_Hub->Post(HubEvent::IoctlDone);
        return;
    }
 
    if (!NT_SUCCESS(HubCreateUcxRequest(m_Hub, Target, &Request)))
    {
        m_Hub->Post(HubEvent::IoctlFailed);
        return;
    }
 
    WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
    Attributes.ParentObject = m_Hub->m_Device;
 
    if (!NT_SUCCESS(WdfMemoryCreate(&Attributes,
                                    NonPagedPool,
                                    HUB_TAG_PORT,
                                    Count * (sizeof(PVOID) + sizeof(ROOTHUB_30PORT_INFO_EX) +
                                             HUB_ROOT_PORT_MAX_SPEEDS * sizeof(*Speeds)),
                                    &Block,
                                    &Buffer)))
    {
        DPRINT1("Hub %p no memory for %lu root 3.0 ports\n", m_Hub, Count);
        goto Failed;
    }
 
    m_Hub->m_Root30Ports = (PROOTHUB_30PORT_INFO_EX*)Buffer;
    Entries = (PROOTHUB_30PORT_INFO_EX)(m_Hub->m_Root30Ports + Count);
    Speeds = (PUSB_DEVICE_CAPABILITY_SUPERSPEEDPLUS_SPEED)(Entries + Count);
 
    for (Index = 0; Index < Count; Index++)
    {
        m_Hub->m_Root30Ports[Index] = &Entries[Index];
        Entries[Index].Info.MinorRevision = 0;
        Entries[Index].Info.HubDepth = 0;
        Entries[Index].Speeds = &Speeds[Index * HUB_ROOT_PORT_MAX_SPEEDS];
        Entries[Index].SpeedsCount = 0;
        Entries[Index].MaxSpeedsCount = HUB_ROOT_PORT_MAX_SPEEDS;
    }
 
    WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
    Attributes.ParentObject = Request;
 
    if (!NT_SUCCESS(WdfMemoryCreate(&Attributes,
                                    NonPagedPool,
                                    HUB_TAG_PORT,
                                    sizeof(*Payload),
                                    &PayloadMemory,
                                    (PVOID*)&Payload)))
    {
        DPRINT1("Hub %p no memory for the 3.0 port info request\n", m_Hub);
        goto Failed;
    }
 
    Payload->Size = sizeof(*Payload);
    Payload->NumberOfPorts = (USHORT)Count;
    Payload->PortInfoSize = sizeof(*Entries);
    Payload->PortInfoArray = (PROOTHUB_30PORT_INFO*)m_Hub->m_Root30Ports;
 
    HubSendUcxIoctl(m_Hub, Target, IOCTL_UCXHUB_ROOTHUB_GET_30PORT_INFO, Payload, Request, HubRoot30PortsComplete);
    return;
 
Failed:
    WdfObjectDelete(Request);
    if (Block != NULL)
    {
        WdfObjectDelete(Block);
        m_Hub->m_Root30Ports = NULL;
    }
    m_Hub->Post(HubEvent::IoctlFailed);
}

Referenced by EnterReadingRootHub30Ports().

◆ GetRootHubInfo()

VOID HubMachine::GetRootHubInfo ( )

private

Definition at line 189 of file ucxlink.cpp.

{
    WDFIOTARGET Target = WdfDeviceGetIoTarget(m_Hub->m_Device);
    WDFREQUEST Request;
 
    if (!NT_SUCCESS(HubCreateUcxRequest(m_Hub, Target, &Request)))
    {
        m_Hub->Post(HubEvent::IoctlFailed);
        return;
    }
 
    m_Hub->m_RootHubInfo.Info.Size = sizeof(m_Hub->m_RootHubInfo);
 
    HubSendUcxIoctl(m_Hub,
                    Target,
                    IOCTL_UCXHUB_ROOTHUB_GET_INFO,
                    &m_Hub->m_RootHubInfo,
                    Request,
                    HubRootHubInfoComplete);
}

Referenced by EnterReadingRootHubInfo().

◆ GetStandardStatus()

VOID HubMachine::GetStandardStatus ( )

private

Definition at line 388 of file hubreq.cpp.

{
    m_Hub->m_Control.SetSetup(0x80, USB_REQUEST_GET_STATUS, 0, 0, sizeof(m_Hub->m_DeviceStatus));
    DPRINT("Hub %p reading device status\n", m_Hub);
    HubSendControl(m_Hub, &m_Hub->m_DeviceStatus, sizeof(m_Hub->m_DeviceStatus), FALSE);
}

Referenced by EnterReadingStandardStatus().

◆ HandleHubChange()

SM_RESULT HubMachine::HandleHubChange ( _In_ HubChange Change )

private

None comes only from the lost change query, Error only from the pending one.

Definition at line 1050 of file hubsm.cpp.

{
    switch (Change)
    {
        case HubChange::OverCurrent:
            ArmOverCurrentTimer();
            return SmTransition(&AwaitingOverCurrentTimer);
 
        case HubChange::OverCurrentCleared:
            return QuiesceWithoutInterrupt(Teardown::Recover);
 
        case HubChange::Error:
            return HandleHubStatusFault();
 
        default:
            return SendInterrupt(TRUE);
    }
}

Referenced by OnAckingHubChange(), and OnReadingHubStatus().

◆ HandleHubStatusFault()

SM_RESULT HubMachine::HandleHubStatusFault ( )

private

Definition at line 1071 of file hubsm.cpp.

{
    if (IsErrorFatal())
        return QuiesceWithoutInterrupt(Teardown::Recover);
 
    return SendInterrupt(TRUE);
}

Referenced by HandleHubChange(), OnListening(), and OnReadingHubStatus().

◆ Hub()

HubFdo * HubMachine::Hub ( ) const

inline

Definition at line 100 of file hubsm.h.

    {
        return m_Hub;
    }

Referenced by Initialize().

◆ Initialize()

VOID HubMachine::Initialize	(	_In_ HubFdo *	Hub,
		_In_ HubKind	Kind
	)

Definition at line 253 of file hubsm.cpp.

{
    m_Hub = Hub;
    m_Kind = Kind;
    m_Teardown = Teardown::Recover;
    m_PowerUp = PowerUp::Start;
    m_StatusRead = StatusRead::Change;
    m_PortStatusReturn = &NotListening;
    m_ReleaseToUnconfigured = FALSE;
    m_FullConfigRead = FALSE;
    m_DromPollStart = 0;
    m_DromIndex = 0;
    m_DromWords = 0;
    m_DromPhase = DromPhase::Header;
    m_DromNext = &QueryingErrata;
 
    SmInitialize(&AwaitingAddDevice);
}

◆ InitializeDescriptorRetries()

VOID HubMachine::InitializeDescriptorRetries ( )

private

Definition at line 1350 of file fdo.cpp.

{
    m_Hub->m_DescriptorRetryCount = 0;
}

Referenced by StartHubConfiguration().

◆ InitializeResetCount()

VOID HubMachine::InitializeResetCount ( )

private

Definition at line 1338 of file fdo.cpp.

{
    m_Hub->m_ResetCount = 0;
}

Referenced by EnterCheckingRecoveryLimit(), and OnPortsResetting().

◆ IsDepthZero()

BOOLEAN HubMachine::IsDepthZero ( )

private

Definition at line 1310 of file fdo.cpp.

{
    return m_Hub->IsRootHub();
}

Referenced by OnListening().

◆ IsDromReadWanted()

BOOLEAN HubMachine::IsDromReadWanted ( )

private

Definition at line 114 of file hubdrom.cpp.

{
    return m_Hub->m_Parent.HubDepth != 0 && m_Hub->m_FwUpdateProtocol == 1;
}

Referenced by StartDromOrSkip().

◆ IsErrorFatal()

BOOLEAN HubMachine::IsErrorFatal ( )

private

Definition at line 651 of file hubreq.cpp.

{
    return TRUE;
}

Referenced by HandleHubStatusFault(), and OverCurrentError().

◆ IsInBootPath()

BOOLEAN HubMachine::IsInBootPath ( )

private

Definition at line 1304 of file fdo.cpp.

{
    return m_Hub->HasFlag(HubFlag::InBootOrPagingPath);
}

Referenced by EnterCheckingRecoveryLimit().

◆ LogResetOnResume()

VOID HubMachine::LogResetOnResume ( )

private

Definition at line 1298 of file fdo.cpp.

{
    DPRINT1("Hub %p was reset on resume\n", m_Hub->m_Device);
}

Referenced by ResumeResetFailed(), and StartPowerUp().

◆ LogResetRecovery()

VOID HubMachine::LogResetRecovery ( )

private

Definition at line 1266 of file fdo.cpp.

{
    DECLARE_CONST_UNICODE_STRING(CountName, L"HardResetCount");
    DECLARE_CONST_UNICODE_STRING(StatusName, L"LastHubResetPortStatus");
    WDFKEY Key;
 
    m_Hub->m_LifetimeRecoveryCount++;
 
    DPRINT1("Hub %p reset recovery %lu, last port status 0x%lx\n",
            m_Hub->m_Device, m_Hub->m_LifetimeRecoveryCount, (ULONG)m_Hub->m_LastResetPortStatus);
 
    if (!NT_SUCCESS(WdfDeviceOpenRegistryKey(m_Hub->m_Device,
                                             PLUGPLAY_REGKEY_DEVICE,
                                             KEY_SET_VALUE,
                                             WDF_NO_OBJECT_ATTRIBUTES,
                                             &Key)))
    {
        return;
    }
 
    WdfRegistryAssignULong(Key, &CountName, m_Hub->m_LifetimeRecoveryCount);
 
    if (m_Hub->m_LastResetPortStatus != 0)
    {
        WdfRegistryAssignULong(Key, &StatusName, m_Hub->m_LastResetPortStatus);
        m_Hub->m_LastResetPortStatus = 0;
    }
 
    WdfRegistryClose(Key);
}

Referenced by EnterLoggingReset(), and EnterReconfiguringAfterReset().

◆ LostHubChange()

HubChange HubMachine::LostHubChange ( )

private

Definition at line 639 of file hubreq.cpp.

{
    return HubChange::None;
}

Referenced by OnReadingHubStatus().

◆ MailboxValue()

ULONG HubMachine::MailboxValue ( )

private

Definition at line 120 of file hubdrom.cpp.

{
    return m_Hub->m_DromMailbox;
}

Referenced by CheckDromStatus(), and OnDromReadingFirstStatus().

◆ OnAckingHubChange()

SM_RESULT HubMachine::OnAckingHubChange ( _In_ HubEvent Event )

private

Definition at line 1029 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::TransferDone:
            return HandleHubChange(PendingHubChange());
 
        case HubEvent::TransferFailed:
            return QuiesceWithoutInterrupt(Teardown::Recover);
 
        default:
            return SmUnhandled();
    }
}

◆ OnAsleep()

SM_RESULT HubMachine::OnAsleep ( _In_ HubEvent Event )

private

Definition at line 1493 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::PortStatusRequest:
            FailPortStatus(TRUE);
            return SmHandled();
 
        case HubEvent::ResetRequested:
            return SmHandled();
 
        case HubEvent::ReleaseHardware:
            QueueStopAfterSuspendToDevices();
            return SmTransition(&AwaitingStopAfterSuspend);
 
        default:
            return SmUnhandled();
    }
}

◆ OnAwaitingAddDevice()

SM_RESULT HubMachine::OnAwaitingAddDevice ( _In_ HubEvent Event )

private

Definition at line 295 of file hubsm.cpp.

{
    if (Event != HubEvent::DeviceAdded)
        return SmUnhandled();
 
    SignalPnpEvent();
    return SmTransition(&Unconfigured);
}

◆ OnAwaitingD0()

SM_RESULT HubMachine::OnAwaitingD0 ( _In_ HubEvent Event )

private

Definition at line 444 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::PortStatusRequest:
            FailPortStatus(FALSE);
            return SmHandled();
 
        case HubEvent::D0Entry:
            AcquirePowerReference();
            return StartPowerUp(PowerUp::Start);
 
        case HubEvent::ReleaseHardware:
            SignalPnpEvent();
            return SmTransition(&Stopped);
 
        default:
            return SmUnhandled();
    }
}

◆ OnAwaitingDescriptorRetry()

SM_RESULT HubMachine::OnAwaitingDescriptorRetry ( _In_ HubEvent Event )

private

Definition at line 1624 of file hubsm.cpp.

{
    if (Event == HubEvent::TimerFired)
        return SmTransition(&ReadingHubDescriptor);
 
    return SmUnhandled();
}

◆ OnAwaitingInterruptEnable()

SM_RESULT HubMachine::OnAwaitingInterruptEnable ( _In_ HubEvent Event )

private

Definition at line 1211 of file hubsm.cpp.

{
    if (Event == HubEvent::PortsEnableInterrupt)
        return QuiesceWithoutInterrupt(m_Teardown);
 
    return SmUnhandled();
}

◆ OnAwaitingInterruptRefs()

SM_RESULT HubMachine::OnAwaitingInterruptRefs ( _In_ HubEvent Event )

private

Definition at line 1201 of file hubsm.cpp.

{
    if (Event == HubEvent::PortsInterruptReleased)
        return AfterInterruptQuiet();
 
    return SmUnhandled();
}

◆ OnAwaitingOverCurrentTimer()

SM_RESULT HubMachine::OnAwaitingOverCurrentTimer ( _In_ HubEvent Event )

private

Definition at line 1089 of file hubsm.cpp.

{
    if (Event == HubEvent::TimerFired)
        return ReadStatus(StatusRead::OverCurrent);
 
    return SmUnhandled();
}

◆ OnAwaitingReleaseAfterFailure()

SM_RESULT HubMachine::OnAwaitingReleaseAfterFailure ( _In_ HubEvent Event )

private

Definition at line 720 of file hubsm.cpp.

{
    if (Event != HubEvent::ReleaseHardware)
        return SmUnhandled();
 
    SignalPnpEvent();
    return SmTransition(m_ReleaseToUnconfigured ? &Unconfigured : &Stopped);
}

◆ OnAwaitingReleaseHardware()

SM_RESULT HubMachine::OnAwaitingReleaseHardware ( _In_ HubEvent Event )

private

Definition at line 709 of file hubsm.cpp.

{
    if (Event != HubEvent::ReleaseHardware)
        return SmUnhandled();
 
    SignalPnpEvent();
    return SmTransition(&Stopped);
}

◆ OnAwaitingResetRetry()

SM_RESULT HubMachine::OnAwaitingResetRetry ( _In_ HubEvent Event )

private

Definition at line 1355 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::TimerFired:
            if (ResetLimitReached())
                return SmTransition(&ReportingFailure);
 
            return SmTransition(&HubResetting);
 
        case HubEvent::PortStatusRequest:
            FailPortStatus(TRUE);
            return SmHandled();
 
        case HubEvent::ResetRequested:
            return SmHandled();
 
        default:
            return SmUnhandled();
    }
}

◆ OnAwaitingStop()

SM_RESULT HubMachine::OnAwaitingStop ( _In_ HubEvent Event )

private

Definition at line 732 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::D0Exit:
            ReleasePowerReference();
            SignalPnpEvent();
            return SmTransition(&RecycleSuspended);
 
        case HubEvent::D0ExitFinal:
            ReleasePowerReference();
            QueueStopToDevices();
            m_Teardown = Teardown::StopAfterReset;
            return SmTransition(&DevicesReleasing);
 
        default:
            return SmUnhandled();
    }
}

◆ OnAwaitingStopAfterSuspend()

SM_RESULT HubMachine::OnAwaitingStopAfterSuspend ( _In_ HubEvent Event )

private

Definition at line 1575 of file hubsm.cpp.

{
    if (Event == HubEvent::DevicesStoppedAfterSuspend)
        return SmTransition(&SurpriseRemoved);
 
    return SmUnhandled();
}

◆ OnCancelingInterrupt()

SM_RESULT HubMachine::OnCancelingInterrupt ( _In_ HubEvent Event )

private

Definition at line 1191 of file hubsm.cpp.

{
    if ((Event == HubEvent::InterruptDone) || (Event == HubEvent::InterruptFailed))
        return AfterInterruptQuiet();
 
    return SmUnhandled();
}

◆ OnCheckingPowerLoss()

SM_RESULT HubMachine::OnCheckingPowerLoss ( _In_ HubEvent Event )

private

Definition at line 1474 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::TransferDone:
            return StartPowerUp(PowerUp::Resume);
 
        case HubEvent::TransferFailed:
            return SmTransition(&ResettingOnResume);
 
        default:
            return SmUnhandled();
    }
}

◆ OnConfiguring()

SM_RESULT HubMachine::OnConfiguring ( _In_ HubEvent Event )

private

Definition at line 362 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::CallSucceeded:
            return StartDromOrSkip(&QueryingErrata);
 
        case HubEvent::CallFailed:
            return FailStart(TRUE);
 
        default:
            return SmUnhandled();
    }
}

◆ OnDevicesAcquiring()

SM_RESULT HubMachine::OnDevicesAcquiring ( _In_ HubEvent Event )

private

Definition at line 829 of file hubsm.cpp.

{
    if (Event != HubEvent::DevicesAcquired)
        return SmUnhandled();
 
    switch (m_PowerUp)
    {
        case PowerUp::Start:
            SignalPnpEvent();
            return ReadStatus(StatusRead::LostChanges);
 
        case PowerUp::ResumeInS0:
            QueueFakeStatusChangeToPorts();
            SignalPnpEvent();
            return SmTransition(&NotListening);
 
        case PowerUp::ResumeResetFailed:
            QueueStopToPorts();
            m_Teardown = Teardown::ResumeFailed;
            return SmTransition(&PortsReleasing);
 
        default:
            return ReadStatus(StatusRead::LostChanges);
    }
}

◆ OnDevicesReleasing()

SM_RESULT HubMachine::OnDevicesReleasing ( _In_ HubEvent Event )

private

Definition at line 1221 of file hubsm.cpp.

{
    if (Event != HubEvent::DevicesReleased)
        return SmUnhandled();
 
    switch (m_Teardown)
    {
        case Teardown::Stop:
            QueueStopToPorts();
            return SmTransition(&PortsReleasing);
 
        case Teardown::Suspend:
            QueueSuspendToPorts();
            return SmTransition(&PortsReleasing);
 
        default:
            return SmTransition(&AwaitingReleaseHardware);
    }
}

◆ OnDown()

SM_RESULT HubMachine::OnDown ( _In_ HubEvent Event )

private

Definition at line 674 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::PortStatusRequest:
            FailPortStatus(FALSE);
            return SmHandled();
 
        case HubEvent::ResetRequested:
            return SmHandled();
 
        default:
            return SmUnhandled();
    }
}

◆ OnDrainingInterruptRefs()

SM_RESULT HubMachine::OnDrainingInterruptRefs ( _In_ HubEvent Event )

private

Definition at line 1172 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::InterruptDone:
        case HubEvent::InterruptFailed:
            return SmTransition(&AwaitingInterruptRefs);
 
        case HubEvent::PortsInterruptReleased:
            CancelStatusChangeRead();
            return SmTransition(&CancelingInterrupt);
 
        default:
            return SmUnhandled();
    }
}

◆ OnDromRead()

SM_RESULT HubMachine::OnDromRead ( _In_ HubEvent Event )

private

Definition at line 490 of file hubsm.cpp.

{
    if (Event == HubEvent::TransferFailed)
        return FinishDrom();
 
    return SmUnhandled();
}

◆ OnDromReadingFirstStatus()

SM_RESULT HubMachine::OnDromReadingFirstStatus ( _In_ HubEvent Event )

private

Definition at line 508 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::TransferDone:
            DPRINT("Hub %p router mailbox status 0x%02lx\n", m_Hub, (MailboxValue() >> 24) & 0x3F);
            return SmTransition(&DromWritingMetadata);
 
        case HubEvent::TransferFailed:
            return SmTransition(&DromWritingMetadata);
 
        default:
            return SmUnhandled();
    }
}

◆ OnDromReadingStatus()

SM_RESULT HubMachine::OnDromReadingStatus ( _In_ HubEvent Event )

private

Definition at line 572 of file hubsm.cpp.

{
    if (Event == HubEvent::TransferDone)
        return CheckDromStatus();
 
    return SmUnhandled();
}

◆ OnDromReadingWord()

SM_RESULT HubMachine::OnDromReadingWord ( _In_ HubEvent Event )

private

Definition at line 629 of file hubsm.cpp.

{
    if (Event == HubEvent::TransferDone)
        return StoreDromWordAndContinue();
 
    return SmUnhandled();
}

◆ OnDromSendingCommand()

SM_RESULT HubMachine::OnDromSendingCommand ( _In_ HubEvent Event )

private

Definition at line 554 of file hubsm.cpp.

{
    if (Event != HubEvent::TransferDone)
        return SmUnhandled();
 
    m_DromPollStart = KeQueryInterruptTime();
    return SmTransition(&DromReadingStatus);
}

◆ OnDromWritingMetadata()

SM_RESULT HubMachine::OnDromWritingMetadata ( _In_ HubEvent Event )

private

Definition at line 537 of file hubsm.cpp.

{
    if (Event == HubEvent::TransferDone)
        return SmTransition(&DromSendingCommand);
 
    return SmUnhandled();
}

◆ OnFinishingConfiguration()

SM_RESULT HubMachine::OnFinishingConfiguration ( _In_ HubEvent Event )

private

Definition at line 1753 of file hubsm.cpp.

{
    if ((Event == HubEvent::CallSucceeded) || (Event == HubEvent::CallFailed))
        return SmReturn(Event);
 
    return SmUnhandled();
}

◆ OnHubResetting()

SM_RESULT HubMachine::OnHubResetting ( _In_ HubEvent Event )

private

Definition at line 1325 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::ResetDone:
            return SmTransition(&ReconfiguringAfterReset);
 
        case HubEvent::ResetFailed:
            return SmTransition(&LoggingReset);
 
        case HubEvent::ResetFailedOnRemoval:
            ArmResetRetryTimer();
            return SmTransition(&AwaitingResetRetry);
 
        default:
            return SmUnhandled();
    }
}

◆ OnListening()

SM_RESULT HubMachine::OnListening ( _In_ HubEvent Event )

private

Definition at line 859 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::ResetRequested:
            AcquirePowerReference();
            return QuiesceWithInterrupt(Teardown::Recover);
 
        case HubEvent::D0Exit:
            return QuiesceWithInterrupt(Teardown::Suspend);
 
        case HubEvent::D0ExitFinal:
            return QuiesceWithInterrupt(Teardown::Stop);
 
        case HubEvent::InterruptDone:
            AcquirePowerReference();
            switch (CheckHubChangeBit())
            {
                case HubCheck::Yes:
                    return ReadStatus(StatusRead::Change);
 
                case HubCheck::Error:
                    return HandleHubStatusFault();
 
                default:
                    QueueStatusChangeToPorts();
                    return SmTransition(&NotListening);
            }
 
        case HubEvent::InterruptFailed:
            AcquirePowerReference();
            if (IsDepthZero() || PipeResetLimitReached())
                return QuiesceWithoutInterrupt(Teardown::Recover);
 
            ResetStatusChangePipe();
            return SmTransition(&ResettingPipe);
 
        case HubEvent::PortStatusRequest:
            return ReadPortStatus(&Listening);
 
        default:
            return SmUnhandled();
    }
}

◆ OnNotListening()

SM_RESULT HubMachine::OnNotListening ( _In_ HubEvent Event )

private

Definition at line 907 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::ResetRequested:
            m_Teardown = Teardown::Recover;
            return SmTransition(&AwaitingInterruptEnable);
 
        case HubEvent::D0Exit:
            ReleasePowerReference();
            m_Teardown = Teardown::Suspend;
            return SmTransition(&AwaitingInterruptEnable);
 
        case HubEvent::D0ExitFinal:
            ReleasePowerReference();
            m_Teardown = Teardown::Stop;
            return SmTransition(&AwaitingInterruptEnable);
 
        case HubEvent::PortsEnableInterrupt:
            return SendInterrupt(TRUE);
 
        case HubEvent::PortStatusRequest:
            return ReadPortStatus(&NotListening);
 
        default:
            return SmUnhandled();
    }
}

◆ OnPortsAcquiring()

SM_RESULT HubMachine::OnPortsAcquiring ( _In_ HubEvent Event )

private

Definition at line 795 of file hubsm.cpp.

{
    if (Event != HubEvent::PortsAcquired)
        return SmUnhandled();
 
    switch (m_PowerUp)
    {
        case PowerUp::PostReset:
            return ReadStatus(StatusRead::LostChanges);
 
        case PowerUp::Resume:
            QueueResumeToDevices();
            SignalPnpEvent();
            break;
 
        case PowerUp::ResumeInS0:
            QueueResumeInS0ToDevices();
            break;
 
        case PowerUp::ResumeWithReset:
            QueueResumeWithResetToDevices();
            SignalPnpEvent();
            break;
 
        default:
            QueueStartToDevices();
            break;
    }
 
    return SmTransition(&DevicesAcquiring);
}

◆ OnPortsReleasing()

SM_RESULT HubMachine::OnPortsReleasing ( _In_ HubEvent Event )

private

Definition at line 1243 of file hubsm.cpp.

{
    if (Event != HubEvent::PortsReleased)
        return SmUnhandled();
 
    switch (m_Teardown)
    {
        case Teardown::Stop:
            return SmTransition(&AwaitingReleaseHardware);
 
        case Teardown::Suspend:
            SignalPnpEvent();
            return SmTransition(&Suspended);
 
        default:
            QueueResetToPorts();
            return SmTransition(&PortsResetting);
    }
}

◆ OnPortsResetting()

SM_RESULT HubMachine::OnPortsResetting ( _In_ HubEvent Event )

private

Definition at line 1265 of file hubsm.cpp.

{
    if (Event != HubEvent::PortsResetReleased)
        return SmUnhandled();
 
    switch (m_Teardown)
    {
        case Teardown::Fatal:
            return SmTransition(&ReportingFailure);
 
        case Teardown::ResumeFailed:
            SignalPnpEvent();
            InitializeResetCount();
            return SmTransition(&HubResetting);
 
        default:
            return SmTransition(&CheckingRecoveryLimit);
    }
}

◆ OnProgrammingHubDepth()

SM_RESULT HubMachine::OnProgrammingHubDepth ( _In_ HubEvent Event )

private

Definition at line 1847 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::TransferDone:
            return SmReturn(HubEvent::CallSucceeded);
 
        case HubEvent::TransferFailed:
            return SmReturn(HubEvent::CallFailed);
 
        default:
            return SmUnhandled();
    }
}

◆ OnQueryingParentInfo()

SM_RESULT HubMachine::OnQueryingParentInfo ( _In_ HubEvent Event )

private

Definition at line 334 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::IoctlDone:
            return SmTransition(&Configuring);
 
        case HubEvent::IoctlFailed:
            return FailStart(TRUE);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReadingConfigDescriptor()

SM_RESULT HubMachine::OnReadingConfigDescriptor ( _In_ HubEvent Event )

private

Definition at line 1670 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::TransferDone:
            if (!m_FullConfigRead && ConfigDescriptorTruncated())
            {
                m_FullConfigRead = TRUE;
                return SmTransition(&ReadingConfigDescriptor);
            }
 
            if (!CacheConfigDescriptor())
                return SmReturn(HubEvent::CallFailed);
 
            return SmTransition(&UpdatingController);
 
        case HubEvent::TransferFailed:
            return SmReturn(HubEvent::CallFailed);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReadingHubDescriptor()

SM_RESULT HubMachine::OnReadingHubDescriptor ( _In_ HubEvent Event )

private

Definition at line 1594 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::TransferDone:
            if (!ParseHubDescriptor())
                return SmReturn(HubEvent::CallFailed);
 
            return SmTransition(&ReadingStandardStatus);
 
        case HubEvent::TransferFailed:
            if (DescriptorRetriesExhausted())
                return SmReturn(HubEvent::CallFailed);
 
            return SmTransition(&AwaitingDescriptorRetry);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReadingHubStatus()

SM_RESULT HubMachine::OnReadingHubStatus ( _In_ HubEvent Event )

private

Definition at line 987 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::TransferDone:
            if (m_StatusRead == StatusRead::LostChanges)
                return HandleHubChange(LostHubChange());
 
            if (m_StatusRead == StatusRead::OverCurrent)
            {
                if (OverCurrentCleared())
                    return QuiesceWithoutInterrupt(Teardown::Recover);
 
                return OverCurrentError();
            }
 
            switch (SelectHubChange())
            {
                case HubCheck::Yes:
                    AckHubChange();
                    return SmTransition(&AckingHubChange);
 
                case HubCheck::Error:
                    return HandleHubStatusFault();
 
                default:
                    return SendInterrupt(TRUE);
            }
 
        case HubEvent::TransferFailed:
            if (m_StatusRead == StatusRead::OverCurrent)
                return OverCurrentError();
 
            return QuiesceWithoutInterrupt(Teardown::Recover);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReadingPortStatus()

SM_RESULT HubMachine::OnReadingPortStatus ( _In_ HubEvent Event )

private

Definition at line 947 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::TransferDone:
            ReplyPortStatus();
            return SmTransition(m_PortStatusReturn);
 
        case HubEvent::TransferFailed:
            FailPortStatus(FALSE);
            return SmTransition(m_PortStatusReturn);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReadingRootHub20Ports()

SM_RESULT HubMachine::OnReadingRootHub20Ports ( _In_ HubEvent Event )

private

Definition at line 1797 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::IoctlDone:
            return SmTransition(&ReadingRootHub30Ports);
 
        case HubEvent::IoctlFailed:
            return SmReturn(HubEvent::CallFailed);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReadingRootHub30Ports()

SM_RESULT HubMachine::OnReadingRootHub30Ports ( _In_ HubEvent Event )

private

Definition at line 1821 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::IoctlDone:
            return SmReturn(HubEvent::CallSucceeded);
 
        case HubEvent::IoctlFailed:
            return SmReturn(HubEvent::CallFailed);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReadingRootHubInfo()

SM_RESULT HubMachine::OnReadingRootHubInfo ( _In_ HubEvent Event )

private

Definition at line 1773 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::IoctlDone:
            return SmTransition(&ReadingRootHub20Ports);
 
        case HubEvent::IoctlFailed:
            return SmReturn(HubEvent::CallFailed);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReadingStandardStatus()

SM_RESULT HubMachine::OnReadingStandardStatus ( _In_ HubEvent Event )

private

Definition at line 1641 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::TransferDone:
            if (!ParsePowerStatus())
                return SmReturn(HubEvent::CallFailed);
 
            m_FullConfigRead = FALSE;
            return SmTransition(&ReadingConfigDescriptor);
 
        case HubEvent::TransferFailed:
            return SmReturn(HubEvent::CallFailed);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReconfiguring()

SM_RESULT HubMachine::OnReconfiguring ( _In_ HubEvent Event )

private

Definition at line 388 of file hubsm.cpp.

{
    switch (Event)
    {
        /* A restart reads the DROM again, as the first start does */
        case HubEvent::CallSucceeded:
            return StartDromOrSkip(&AwaitingD0);
 
        case HubEvent::CallFailed:
            return FailStart(FALSE);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReconfiguringAfterReset()

SM_RESULT HubMachine::OnReconfiguringAfterReset ( _In_ HubEvent Event )

private

Definition at line 1396 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::CallSucceeded:
            return StartPowerUp(PowerUp::PostReset);
 
        case HubEvent::CallFailed:
            return QuiesceWithoutInterrupt(Teardown::Recover);
 
        default:
            return SmUnhandled();
    }
}

◆ OnReconfiguringAfterResume()

SM_RESULT HubMachine::OnReconfiguringAfterResume ( _In_ HubEvent Event )

private

Definition at line 1446 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::CallSucceeded:
            return StartPowerUp(PowerUp::ResumeWithReset);
 
        case HubEvent::CallFailed:
            return ResumeResetFailed();
 
        default:
            return SmUnhandled();
    }
}

◆ OnRecycleSuspended()

SM_RESULT HubMachine::OnRecycleSuspended ( _In_ HubEvent Event )

private

Definition at line 1544 of file hubsm.cpp.

{
    if ((Event != HubEvent::D0Entry) && (Event != HubEvent::D0EntryFromSx))
        return SmUnhandled();
 
    AcquirePowerReference();
    SignalPnpEvent();
    return SmTransition(&AwaitingStop);
}

◆ OnResettingOnResume()

SM_RESULT HubMachine::OnResettingOnResume ( _In_ HubEvent Event )

private

Definition at line 1413 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::ResetDone:
            return SmTransition(&ReconfiguringAfterResume);
 
        case HubEvent::ResetFailed:
        case HubEvent::ResetFailedOnRemoval:
            return ResumeResetFailed();
 
        default:
            return SmUnhandled();
    }
}

◆ OnResettingPipe()

SM_RESULT HubMachine::OnResettingPipe ( _In_ HubEvent Event )

private

Definition at line 1099 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::PipeResetDone:
            return SendInterrupt(FALSE);
 
        case HubEvent::PipeResetFailed:
            return QuiesceWithoutInterrupt(Teardown::Recover);
 
        default:
            return SmUnhandled();
    }
}

◆ OnSettingConfiguration()

SM_RESULT HubMachine::OnSettingConfiguration ( _In_ HubEvent Event )

private

Definition at line 1727 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::ConfigurationSet:
            if (m_Kind == HubKind::Usb30)
                return SmTransition(&FinishingConfiguration);
 
            return SmReturn(HubEvent::CallSucceeded);
 
        case HubEvent::ConfigurationFailed:
            return SmReturn(HubEvent::CallFailed);
 
        default:
            return SmUnhandled();
    }
}

◆ OnStopped()

SM_RESULT HubMachine::OnStopped ( _In_ HubEvent Event )

private

Definition at line 692 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::PrepareHardware:
            return SmTransition(&Reconfiguring);
 
        case HubEvent::DeviceCleanup:
            return SmTransition(&Deleted);
 
        default:
            return SmUnhandled();
    }
}

◆ OnSurpriseRemoved()

SM_RESULT HubMachine::OnSurpriseRemoved ( _In_ HubEvent Event )

private

Definition at line 754 of file hubsm.cpp.

{
    if (Event == HubEvent::DeviceCleanup)
        return SmTransition(&Deleted);
 
    return SmUnhandled();
}

◆ OnSuspended()

SM_RESULT HubMachine::OnSuspended ( _In_ HubEvent Event )

private

Definition at line 1515 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::ResetRequested:
            return SmTransition(&SuspendedResetPending);
 
        case HubEvent::PortStatusRequest:
            ReplyPortStatus();
            return SmHandled();
 
        case HubEvent::D0Entry:
            AcquirePowerReference();
            return StartPowerUp(PowerUp::ResumeInS0);
 
        case HubEvent::D0EntryFromSx:
            AcquirePowerReference();
            if (WasResetByParent())
                return SmTransition(&ReconfiguringAfterResume);
 
            return CheckPowerLoss();
 
        default:
            return SmUnhandled();
    }
}

◆ OnSuspendedResetPending()

SM_RESULT HubMachine::OnSuspendedResetPending ( _In_ HubEvent Event )

private

Definition at line 1564 of file hubsm.cpp.

{
    if ((Event != HubEvent::D0Entry) && (Event != HubEvent::D0EntryFromSx))
        return SmUnhandled();
 
    (VOID)WasResetByParent();
    return SmTransition(&ResettingOnResume);
}

◆ OnUnconfigured()

SM_RESULT HubMachine::OnUnconfigured ( _In_ HubEvent Event )

private

Definition at line 306 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::PrepareHardware:
            /* The root hub has no parent to ask */
            if (m_Kind == HubKind::Root)
                return SmTransition(&Configuring);
 
            return SmTransition(&QueryingParentInfo);
 
        case HubEvent::DeviceCleanup:
            return SmTransition(&Deleted);
 
        default:
            return SmUnhandled();
    }
}

◆ OnUpdatingController()

SM_RESULT HubMachine::OnUpdatingController ( _In_ HubEvent Event )

private

Definition at line 1703 of file hubsm.cpp.

{
    switch (Event)
    {
        case HubEvent::IoctlDone:
            return SmTransition(&SettingConfiguration);
 
        case HubEvent::IoctlFailed:
            return SmReturn(HubEvent::CallFailed);
 
        default:
            return SmUnhandled();
    }
}

◆ OverCurrentCleared()

BOOLEAN HubMachine::OverCurrentCleared ( )

private

Definition at line 645 of file hubreq.cpp.

{
    return (m_Hub->m_HubStatus.HubStatus.AsUshort16 & HS_OVER_CURRENT) == 0;
}

Referenced by OnReadingHubStatus().

◆ OverCurrentError()

SM_RESULT HubMachine::OverCurrentError ( )

private

Definition at line 1080 of file hubsm.cpp.

{
    if (IsErrorFatal())
        return QuiesceWithoutInterrupt(Teardown::Fatal);
 
    return QuiesceWithoutInterrupt(Teardown::Recover);
}

Referenced by OnReadingHubStatus().

◆ ParseDromIdentity()

VOID HubMachine::ParseDromIdentity ( )

private

Finds the router identity entry of a version 1 DROM, bounds checking each entry.

Definition at line 201 of file hubdrom.cpp.

{
    HubRouterIdentity* Identity = &m_Hub->m_RouterIdentity;
    const UCHAR* Drom = (const UCHAR*)m_Hub->m_DromPool;
    const UCHAR* Entry;
    ULONG Length = m_Hub->m_DromLength;
    ULONG Offset;
 
    if (Drom == NULL || Drom[DROM_VERSION_OFFSET] != 1)
        return;
 
    for (Offset = DROM_FIRST_ENTRY; Offset + DROM_ENTRY_HEADER <= Length; Offset += Entry[0])
    {
        Entry = &Drom[Offset];
 
        if (Entry[0] == 0)
        {
            DPRINT1("Hub %p router DROM has a zero length entry at %lu\n", m_Hub, Offset);
            return;
        }
 
        if (Entry[0] > Length - Offset)
        {
            DPRINT1("Hub %p router DROM entry at %lu overruns the DROM\n", m_Hub, Offset);
            return;
        }
 
        if ((Entry[1] & DROM_ENTRY_ADAPTER) || (Entry[1] & DROM_ENTRY_TYPE_MASK) != DROM_ENTRY_TYPE_IDENTITY)
            continue;
 
        if (Entry[0] < DROM_IDENTITY_LENGTH)
        {
            DPRINT1("Hub %p router DROM identity entry is only %u bytes\n", m_Hub, Entry[0]);
            return;
        }
 
        /* QUIRK: a later read that fails keeps this identity */
        Identity->VendorId = HubDromReadUshort(&Entry[DROM_IDENTITY_VENDOR]);
        Identity->ProductId = HubDromReadUshort(&Entry[DROM_IDENTITY_PRODUCT]);
        Identity->BcdDevice = HubDromReadUshort(&Entry[DROM_IDENTITY_BCD]);
        Identity->Revision = Entry[DROM_IDENTITY_REVISION];
        Identity->Known = TRUE;
 
        DPRINT("Hub %p router VID %04X PID %04X BCD %04X REV %04X\n",
               m_Hub, Identity->VendorId, Identity->ProductId, Identity->BcdDevice, Identity->Revision);
        return;
    }
 
    DPRINT1("Hub %p router DROM has no identity entry\n", m_Hub);
}

Referenced by FinishDrom().

◆ ParseHubDescriptor()

BOOLEAN HubMachine::ParseHubDescriptor ( )

private

Definition at line 552 of file hubreq.cpp.

{
    USHORT Characteristics;
    ULONG OverCurrentMode;
 
    switch (m_Hub->m_Parent.HubSpeed)
    {
        case UsbFullSpeed:
        case UsbHighSpeed:
            if (!HubCheckUsb2HubDescriptor(m_Hub, &m_Hub->m_HubDescriptor.Usb20, sizeof(m_Hub->m_HubDescriptor.Usb20)))
                return FALSE;
 
            m_Hub->m_PortCount = m_Hub->m_HubDescriptor.Usb20.bNumberOfPorts;
            Characteristics = m_Hub->m_HubDescriptor.Usb20.wHubCharacteristics;
 
            if (Characteristics & 0x0001)
                m_Hub->SetFlag(HubFlag::PerPortPower);
            if (Characteristics & 0x0008)
                m_Hub->SetFlag(HubFlag::PerPortOverCurrent);
            return TRUE;
 
        case UsbSuperSpeed:
            if (!HubCheckUsb3HubDescriptor(m_Hub, &m_Hub->m_HubDescriptor.Usb30, sizeof(m_Hub->m_HubDescriptor.Usb30)))
                return FALSE;
 
            m_Hub->m_PortCount = m_Hub->m_HubDescriptor.Usb30.bNumberOfPorts;
            Characteristics = m_Hub->m_HubDescriptor.Usb30.wHubCharacteristics;
            OverCurrentMode = (Characteristics >> 3) & 0x3;
 
            if (Characteristics & 0x0001)
                m_Hub->SetFlag(HubFlag::PerPortPower);
            if (OverCurrentMode == 1)
                m_Hub->SetFlag(HubFlag::PerPortOverCurrent);
            else if (OverCurrentMode >= 2)
                m_Hub->SetFlag(HubFlag::NoOverCurrentProtection);
            return TRUE;
 
        default:
            DPRINT1("Hub %p of speed %lu has no hub descriptor to parse\n", m_Hub, (ULONG)m_Hub->m_Parent.HubSpeed);
            return FALSE;
    }
}

Referenced by OnReadingHubDescriptor().

◆ ParsePowerStatus()

BOOLEAN HubMachine::ParsePowerStatus ( )

private

Definition at line 596 of file hubreq.cpp.

{
    m_Hub->m_MaxPortPower = m_Hub->m_DeviceStatus.SelfPowered ? 500 : 100;
    return TRUE;
}

Referenced by OnReadingStandardStatus().

◆ PendingHubChange()

HubChange HubMachine::PendingHubChange ( )

private

Definition at line 632 of file hubreq.cpp.

{
    return m_Hub->m_SelectedChange;
}

Referenced by OnAckingHubChange().

◆ PipeResetLimitReached()

BOOLEAN HubMachine::PipeResetLimitReached ( )

private

Definition at line 1369 of file fdo.cpp.

{
    if (++m_Hub->m_ResetCount <= HUB_RESET_LIMIT)
        return FALSE;
 
    DPRINT1("Hub %p interrupt pipe reset limit reached\n", m_Hub->m_Device);
    return TRUE;
}

Referenced by OnListening().

◆ PortInterruptRefsReleased()

BOOLEAN HubMachine::PortInterruptRefsReleased ( )

private

Definition at line 859 of file fanout.cpp.

{
    return m_Hub->PortInterruptRefsReleased();
}

Referenced by QuiesceWithInterrupt(), and QuiesceWithoutInterrupt().

◆ QueryControllerInfo()

VOID HubMachine::QueryControllerInfo ( )

private

Definition at line 150 of file ucxlink.cpp.

{
    /* A hub with the full size stack interface gets the 8 byte aligned layout */
    m_Hub->m_Stack.QueryControllerBus(m_Hub->UsbDevice(), (PUCXHUB_CONTROLLER_INFO)&m_Hub->m_ControllerInfo);
}

Referenced by EnterConfiguring(), and EnterReadingRootHubInfo().

◆ QueryErrataFlags()

VOID HubMachine::QueryErrataFlags ( )

private

Definition at line 825 of file hubregistry.cpp.

{
    HubIdStrings Ids;
    NTSTATUS Status;
 
    if (m_Hub->IsRootHub())
        HubFormatControllerIds(&m_Hub->m_ControllerInfo, &Ids);
    else
        HubFormatIdStrings(&m_Hub->m_ParentInfo.DeviceDescriptor, &Ids);
 
    HubQueryVerifierFlags(&m_Hub->m_ParentInfo.DeviceDescriptor, &Ids, L"hub", &m_Hub->m_VerifierFlags);
 
    Status = HubQueryHubErrata(m_Hub, &Ids);
    if (!NT_SUCCESS(Status))
        DPRINT1("Hub %p usbflags query failed 0x%lx\n", m_Hub, Status);
}

Referenced by EnterQueryingErrata().

◆ QueueFakeStatusChangeToPorts()

VOID HubMachine::QueueFakeStatusChangeToPorts ( )

private

Definition at line 926 of file fanout.cpp.

{
    m_Hub->QueueFakeStatusChangeToPorts();
}

Referenced by OnDevicesAcquiring().

◆ QueuePassiveWork()

VOID HubMachine::QueuePassiveWork ( )

private

Definition at line 1202 of file fdo.cpp.

{
    m_Hub->EnqueueWorkItem(m_Hub->m_WorkItem, HubFdo::MachineWorkItem, m_Hub, m_Hub->m_NeedsForwardProgress);
}

Referenced by SmQueuePassive().

◆ QueueResetToPorts()

VOID HubMachine::QueueResetToPorts ( )

private

Definition at line 914 of file fanout.cpp.

{
    m_Hub->QueueResetToPorts();
}

Referenced by OnPortsReleasing().

◆ QueueResumeInS0ToDevices()

VOID HubMachine::QueueResumeInS0ToDevices ( )

private

Definition at line 962 of file fanout.cpp.

{
    m_Hub->QueuePowerUpToDevices(DsmEvent::HubResumedInS0);
}

Referenced by OnPortsAcquiring().

◆ QueueResumeInS0ToPorts()

VOID HubMachine::QueueResumeInS0ToPorts ( )

private

Definition at line 884 of file fanout.cpp.

{
    m_Hub->QueuePowerUpToPorts(PortEvent::HubResumedInS0);
}

Referenced by StartPowerUp().

◆ QueueResumeToDevices()

VOID HubMachine::QueueResumeToDevices ( )

private

Definition at line 956 of file fanout.cpp.

{
    m_Hub->QueuePowerUpToDevices(DsmEvent::HubResumed);
}

Referenced by OnPortsAcquiring().

◆ QueueResumeToPorts()

VOID HubMachine::QueueResumeToPorts ( )

private

Definition at line 878 of file fanout.cpp.

{
    m_Hub->QueuePowerUpToPorts(PortEvent::HubResumed);
}

Referenced by StartPowerUp().

◆ QueueResumeWithResetToDevices()

VOID HubMachine::QueueResumeWithResetToDevices ( )

private

Definition at line 968 of file fanout.cpp.

{
    m_Hub->QueuePowerUpToDevices(DsmEvent::HubResumedWithReset);
}

Referenced by OnPortsAcquiring(), and ResumeResetFailed().

◆ QueueResumeWithResetToPorts()

VOID HubMachine::QueueResumeWithResetToPorts ( )

private

Definition at line 890 of file fanout.cpp.

{
    m_Hub->QueuePowerUpToPorts(PortEvent::HubResumedWithReset);
}

Referenced by StartPowerUp().

◆ QueueStartToDevices()

VOID HubMachine::QueueStartToDevices ( )

private

Definition at line 950 of file fanout.cpp.

{
    m_Hub->QueuePowerUpToDevices(DsmEvent::HubStarted);
}

Referenced by OnPortsAcquiring().

◆ QueueStartToPorts()

VOID HubMachine::QueueStartToPorts ( )

private

Definition at line 871 of file fanout.cpp.

{
    InterlockedExchange(&m_Hub->m_Mux.HubResetInProgress, 0);
    m_Hub->QueuePowerUpToPorts(PortEvent::HubStarted);
}

Referenced by StartPowerUp().

◆ QueueStatusChangeToPorts()

VOID HubMachine::QueueStatusChangeToPorts ( )

private

Definition at line 920 of file fanout.cpp.

{
    m_Hub->QueueStatusChangeToPorts();
}

Referenced by OnListening().

◆ QueueStopAfterSuspendToDevices()

VOID HubMachine::QueueStopAfterSuspendToDevices ( )

private

Definition at line 944 of file fanout.cpp.

{
    m_Hub->QueuePowerDownToDevices(DsmEvent::HubStoppingAfterSuspend, HubDeviceFanOut::StopWhileSuspended);
}

Referenced by OnAsleep().

◆ QueueStopToDevices()

VOID HubMachine::QueueStopToDevices ( )

private

Definition at line 932 of file fanout.cpp.

{
    m_Hub->QueuePowerDownToDevices(DsmEvent::HubStopping, HubDeviceFanOut::PowerDown);
}

Referenced by AfterInterruptQuiet(), and OnAwaitingStop().

◆ QueueStopToPorts()

VOID HubMachine::QueueStopToPorts ( )

private

Definition at line 896 of file fanout.cpp.

{
    m_Hub->QueueStopToPorts();
}

Referenced by AfterInterruptQuiet(), OnDevicesAcquiring(), and OnDevicesReleasing().

◆ QueueSurpriseRemovalToPorts()

VOID HubMachine::QueueSurpriseRemovalToPorts ( )

private

Definition at line 908 of file fanout.cpp.

{
    m_Hub->QueueSurpriseRemovalToPorts();
}

Referenced by QuiesceWithInterrupt(), and QuiesceWithoutInterrupt().

◆ QueueSuspendToDevices()

VOID HubMachine::QueueSuspendToDevices ( )

private

Definition at line 938 of file fanout.cpp.

{
    m_Hub->QueuePowerDownToDevices(DsmEvent::HubSuspending, HubDeviceFanOut::PowerDown);
}

Referenced by AfterInterruptQuiet().

◆ QueueSuspendToPorts()

VOID HubMachine::QueueSuspendToPorts ( )

private

Definition at line 902 of file fanout.cpp.

{
    m_Hub->QueueSuspendToPorts();
}

Referenced by OnDevicesReleasing().

◆ QuiesceWithInterrupt()

SM_RESULT HubMachine::QuiesceWithInterrupt ( _In_ Teardown Reason )

private

Definition at line 1119 of file hubsm.cpp.

{
    BOOLEAN released = PortInterruptRefsReleased();
 
    if (Reason == Teardown::Recover)
        QueueSurpriseRemovalToPorts();
 
    m_Teardown = Reason;
 
    if (!released)
        return SmTransition(&DrainingInterruptRefs);
 
    CancelStatusChangeRead();
    return SmTransition(&CancelingInterrupt);
}

Referenced by OnListening().

◆ QuiesceWithoutInterrupt()

SM_RESULT HubMachine::QuiesceWithoutInterrupt ( _In_ Teardown Reason )

private

Definition at line 1138 of file hubsm.cpp.

{
    if ((Reason == Teardown::Recover) || (Reason == Teardown::Fatal))
        QueueSurpriseRemovalToPorts();
 
    m_Teardown = Reason;
 
    if (!PortInterruptRefsReleased())
        return SmTransition(&AwaitingInterruptRefs);
 
    return AfterInterruptQuiet();
}

Referenced by HandleHubChange(), HandleHubStatusFault(), OnAckingHubChange(), OnAwaitingInterruptEnable(), OnListening(), OnReadingHubStatus(), OnReconfiguringAfterReset(), OnResettingPipe(), and OverCurrentError().

◆ ReadDromRegister()

VOID HubMachine::ReadDromRegister ( _In_ USHORT Register )

private

Definition at line 134 of file hubdrom.cpp.

{
    HubMailboxTransfer(m_Hub, FALSE, Register);
}

Referenced by EnterDromReadingFirstStatus(), EnterDromReadingStatus(), and EnterDromReadingWord().

◆ ReadPortStatus()

SM_RESULT HubMachine::ReadPortStatus ( _In_ const State * ReturnTo )

private

Definition at line 938 of file hubsm.cpp.

{
    GetPortStatus();
    m_PortStatusReturn = ReturnTo;
    return SmTransition(&ReadingPortStatus);
}

Referenced by OnListening(), and OnNotListening().

◆ ReadStatus()

SM_RESULT HubMachine::ReadStatus ( _In_ StatusRead Purpose )

private

Definition at line 978 of file hubsm.cpp.

{
    GetHubStatus();
    m_StatusRead = Purpose;
    return SmTransition(&ReadingHubStatus);
}

◆ RecoveryLimitReached()

BOOLEAN HubMachine::RecoveryLimitReached ( )

private

Definition at line 1391 of file fdo.cpp.

{
    LARGE_INTEGER Now;
 
    KeQuerySystemTime(&Now);
 
    if (Now.QuadPart - m_Hub->m_FirstRecoveryTime.QuadPart > HUB_RECOVERY_WINDOW)
    {
        m_Hub->m_RecoveryCount = 1;
        m_Hub->m_FirstRecoveryTime = Now;
        return FALSE;
    }
 
    if (++m_Hub->m_RecoveryCount < HUB_RECOVERY_LIMIT)
        return FALSE;
 
    DPRINT1("Hub %p too many resets in a minute\n", m_Hub->m_Device);
    m_Hub->m_FailureMessageId = HUB_MSG_HUB_RESET_FAILED;
    return TRUE;
}

Referenced by EnterCheckingRecoveryLimit().

◆ ReferenceHub()

VOID HubMachine::ReferenceHub ( )

private

Definition at line 1190 of file fdo.cpp.

{
    WdfObjectReference(m_Hub->m_Device);
}

Referenced by SmReference().

◆ ReleaseDromBuffer()

VOID HubMachine::ReleaseDromBuffer ( )

private

Definition at line 178 of file hubdrom.cpp.

{
    if (m_Hub->m_DromPool != NULL)
        ExFreePoolWithTag(m_Hub->m_DromPool, HUB_TAG_HUB);
 
    m_Hub->m_DromPool = NULL;
    m_Hub->m_DromBuffer = NULL;
    m_Hub->m_DromLength = 0;
}

Referenced by FinishDrom().

◆ ReleasePowerReference()

VOID HubMachine::ReleasePowerReference ( )

private

Definition at line 1216 of file fdo.cpp.

{
    m_Hub->ReleasePowerReference();
}

Referenced by OnAwaitingStop(), OnNotListening(), and SendInterrupt().

◆ ReplyPortStatus()

VOID HubMachine::ReplyPortStatus ( )

private

Definition at line 818 of file hubreq.cpp.

{
    HubPort* Port = m_Hub->m_PortStatusTarget;
    USHORT Status = Port->m_Current.StatusChange.PortStatus.AsUshort16;
    USHORT Change = Port->m_Current.StatusChange.PortChange.AsUshort16;
    WDF_REQUEST_PARAMETERS Params;
    WDFREQUEST Request = HubTakePortStatusRequest(m_Hub, &Params);
    WDFMEMORY Memory;
    NTSTATUS Result;
    PULONG Bits;
    HubPdo* Pdo;
 
    switch (Params.Parameters.DeviceIoControl.IoControlCode)
    {
        case IOCTL_USB_GET_PORT_STATUS:
            Result = WdfRequestRetrieveOutputMemory(Request, &Memory);
            if (!NT_SUCCESS(Result))
            {
                DPRINT1("Hub %p port %u status output buffer missing 0x%lx\n", m_Hub, Port->Number(), Result);
                WdfRequestComplete(Request, Result);
                return;
            }
 
            *(PUSHORT)((PUCHAR)WdfMemoryGetBuffer(Memory, NULL) + HUB_USER_PORT_STATUS_OFFSET) = Status;
            WdfRequestCompleteWithInformation(Request, STATUS_SUCCESS, HUB_USER_PORT_STATUS_SIZE);
            return;
 
        case IOCTL_INTERNAL_USB_GET_PORT_STATUS:
            Bits = (PULONG)Params.Parameters.Others.Arg1;
            Pdo = (HubPdo*)Params.Parameters.Others.Arg2;
            Result = STATUS_SUCCESS;
 
            if (Status & PS_CONNECTED)
                *Bits |= USBD_PORT_CONNECTED;
            else
                Result = STATUS_NO_SUCH_DEVICE;
 
            if (Status & PS_ENABLED)
            {
                if (Pdo->m_Flags & (LONG)PdoFlag::ReportPortDisabled)
                    InterlockedAnd(&Pdo->m_Flags, ~(LONG)PdoFlag::ReportPortDisabled);
                else
                    *Bits |= USBD_PORT_ENABLED;
            }
 
            if (Change & PC_CONNECT)
                Result = STATUS_NO_SUCH_DEVICE;
 
            if (!NT_SUCCESS(Result))
            {
                DPRINT1("Hub %p port %u status 0x%x change 0x%x reported as no device\n",
                        m_Hub, Port->Number(), Status, Change);
            }
 
            WdfRequestComplete(Request, Result);
            return;
 
        default:
            DPRINT1("Hub %p port status request with IOCTL 0x%lx\n",
                    m_Hub, Params.Parameters.DeviceIoControl.IoControlCode);
            WdfRequestComplete(Request, STATUS_ADAPTER_HARDWARE_ERROR);
            return;
    }
}

Referenced by OnReadingPortStatus(), and OnSuspended().

◆ ReportFailureToPnp()

VOID HubMachine::ReportFailureToPnp ( )

private

Definition at line 1241 of file fdo.cpp.

{
    DPRINT1("Hub %p failed in state %s, message 0x%lx\n",
            m_Hub->m_Device, SmCurrent()->Name, m_Hub->m_FailureMessageId);
 
    if (m_Hub->m_FailureMessageId != 0)
        HubReportPnpProblem(m_Hub->m_Device, m_Hub->m_FailureMessageId);
 
    WdfDeviceSetFailed(m_Hub->m_Device, WdfDeviceFailedNoRestart);
}

Referenced by EnterReportingFailure().

◆ ResetHub()

VOID HubMachine::ResetHub ( )

private

Definition at line 301 of file upstream.cpp.

{
    WDFREQUEST Request;
 
    if (!NT_SUCCESS(HubCreateParentRequest(m_Hub, &Request)))
    {
        m_Hub->Post(HubEvent::ResetFailed);
        return;
    }
 
    m_Hub->m_ResetFlags = 0;
    DPRINT("Hub %p asking parent for a reset\n", m_Hub);
 
    if (!HubSendToParent(m_Hub, Request, IOCTL_UCXHUB_RESET_PORT_ASYNC, &m_Hub->m_ResetFlags, HubResetComplete, m_Hub))
    {
        WdfObjectDelete(Request);
        m_Hub->Post(HubEvent::ResetFailed);
    }
}

Referenced by EnterHubResetting().

◆ ResetLimitReached()

BOOLEAN HubMachine::ResetLimitReached ( )

private

Definition at line 1356 of file fdo.cpp.

{
    USHORT Previous = m_Hub->m_ResetCount++;
 
    if (Previous <= HUB_RESET_LIMIT)
        return FALSE;
 
    DPRINT1("Hub %p reset failed %lu times\n", m_Hub->m_Device, (ULONG)Previous + 1);
    m_Hub->m_FailureMessageId = HUB_MSG_HUB_RESET_FAILED;
    return TRUE;
}

Referenced by OnAwaitingResetRetry().

◆ ResetStatusChangePipe()

VOID HubMachine::ResetStatusChangePipe ( )

private

Definition at line 247 of file upstream.cpp.

{
    struct _URB_PIPE_REQUEST* Urb = &m_Hub->m_PipeUrb;
 
    RtlZeroMemory(Urb, sizeof(*Urb));
    Urb->Hdr.Length = sizeof(*Urb);
    Urb->Hdr.Function = URB_FUNCTION_SYNC_RESET_PIPE_AND_CLEAR_STALL;
    Urb->Hdr.UsbdDeviceHandle = m_Hub->UsbDevice();
    Urb->PipeHandle = m_Hub->m_Interrupt.Pipe;
 
    if (!HubSendToParent(m_Hub, m_Hub->m_Control.Request, IOCTL_INTERNAL_USB_SUBMIT_URB, Urb, HubPipeResetComplete, m_Hub))
    {
        m_Hub->m_Control.Reuse();
        m_Hub->Post(HubEvent::PipeResetFailed);
    }
}

Referenced by OnListening().

◆ ResumeResetFailed()

SM_RESULT HubMachine::ResumeResetFailed ( )

private

Definition at line 1431 of file hubsm.cpp.

{
    LogResetOnResume();
    QueueResumeWithResetToDevices();
    m_PowerUp = PowerUp::ResumeResetFailed;
    return SmTransition(&DevicesAcquiring);
}

Referenced by OnReconfiguringAfterResume(), and OnResettingOnResume().

◆ SelectHubChange()

HubCheck HubMachine::SelectHubChange ( )

private

Definition at line 603 of file hubreq.cpp.

{
    USHORT Status = m_Hub->m_HubStatus.HubStatus.AsUshort16;
    USHORT Change = m_Hub->m_HubStatus.HubChange.AsUshort16;
 
    if (Change & HS_OVER_CURRENT)
    {
        DPRINT1("Hub %p over current change, hub status 0x%x\n", m_Hub, Status);
        HubNoteHubOverCurrent(m_Hub);
        m_Hub->m_SelectedChange = (Status & HS_OVER_CURRENT) ? HubChange::OverCurrent : HubChange::OverCurrentCleared;
        m_Hub->m_SelectedFeature = HUB_C_OVER_CURRENT;
        return HubCheck::Yes;
    }
 
    if (Change & HS_LOCAL_POWER_LOST)
    {
        DPRINT("Hub %p local power change, hub status 0x%x\n", m_Hub, Status);
        m_Hub->m_SelectedChange = (Status & HS_LOCAL_POWER_LOST) ? HubChange::PowerLost : HubChange::PowerGood;
        m_Hub->m_SelectedFeature = HUB_C_LOCAL_POWER;
        return HubCheck::Yes;
    }
 
    if (Change != 0)
        DPRINT1("Hub %p reports unknown hub change 0x%x\n", m_Hub, Change);
 
    return (Change != 0) ? HubCheck::Error : HubCheck::No;
}

Referenced by OnReadingHubStatus().

◆ SelectHubConfiguration()

VOID HubMachine::SelectHubConfiguration ( )

private

Definition at line 128 of file upstream.cpp.

{
    USBD_INTERFACE_LIST_ENTRY List[2];
    PUSB_INTERFACE_DESCRIPTOR Interface;
    WDFREQUEST Request = NULL;
    PURB Urb = NULL;
 
    Interface = HubFindHubInterface(m_Hub);
    if (Interface == NULL ||
        Interface->bInterfaceClass != HUB_CLASS_CODE ||
        Interface->bNumEndpoints == 0)
    {
        DPRINT1("Hub %p has no usable hub interface\n", m_Hub);
        goto Failed;
    }
 
    RtlZeroMemory(List, sizeof(List));
    List[0].InterfaceDescriptor = Interface;
 
    Urb = USBD_CreateConfigurationRequestEx(m_Hub->m_ConfigDescriptor, List);
    if (Urb == NULL)
    {
        DPRINT1("Hub %p select configuration URB not built\n", m_Hub);
        goto Failed;
    }
 
    DPRINT("Hub %p selecting interface %u protocol %u\n",
           m_Hub, Interface->bInterfaceNumber, Interface->bInterfaceProtocol);
 
    if (!NT_SUCCESS(HubCreateParentRequest(m_Hub, &Request)))
        goto Failed;
 
    if (HubSendToParent(m_Hub, Request, IOCTL_INTERNAL_USB_SUBMIT_URB, Urb, HubConfigurationComplete, Urb))
        return;
 
Failed:
    if (Request != NULL)
        WdfObjectDelete(Request);
    if (Urb != NULL)
        ExFreePool(Urb);
 
    m_Hub->Post(HubEvent::ConfigurationFailed);
}

Referenced by EnterSettingConfiguration().

◆ SendInterrupt()

SM_RESULT HubMachine::SendInterrupt ( _In_ BOOLEAN ClearPipeResets )

private

Definition at line 966 of file hubsm.cpp.

{
    ReleasePowerReference();
    StartStatusChangeRead();
    if (ClearPipeResets)
        ClearPipeResetCount();
 
    return SmTransition(&Listening);
}

Referenced by HandleHubChange(), HandleHubStatusFault(), OnNotListening(), OnReadingHubStatus(), and OnResettingPipe().

◆ SetHubDepth()

VOID HubMachine::SetHubDepth ( )

private

Definition at line 408 of file hubreq.cpp.

{
    m_Hub->m_Control.SetSetup(0x20, HUB_REQUEST_SET_HUB_DEPTH, (USHORT)(m_Hub->m_Parent.HubDepth - 1), 0, 0);
    DPRINT("Hub %p setting hub depth %lu\n", m_Hub, (ULONG)m_Hub->m_Parent.HubDepth - 1);
    HubSendControl(m_Hub, NULL, 0, FALSE);
}

Referenced by EnterProgrammingHubDepth().

◆ SignalPnpEvent()

VOID HubMachine::SignalPnpEvent ( )

private

Definition at line 1222 of file fdo.cpp.

{
    DPRINT("Hub %p PnP event done in %s\n", m_Hub->m_Device, SmCurrent()->Name);
 
    m_Hub->m_PnpStatus = STATUS_SUCCESS;
    KeSetEvent(&m_Hub->m_PnpEvent, IO_NO_INCREMENT, FALSE);
}

Referenced by EnterSignalPnp(), OnAwaitingAddDevice(), OnAwaitingD0(), OnAwaitingReleaseAfterFailure(), OnAwaitingReleaseHardware(), OnAwaitingStop(), OnDevicesAcquiring(), OnPortsAcquiring(), OnPortsReleasing(), OnPortsResetting(), and OnRecycleSuspended().

◆ SignalPnpFailure()

VOID HubMachine::SignalPnpFailure ( )

private

Definition at line 1231 of file fdo.cpp.

{
    DPRINT1("Hub %p start failed in state %s, depth %lu\n",
            m_Hub->m_Device, SmCurrent()->Name, SmDepth());
 
    m_Hub->m_PnpStatus = STATUS_UNSUCCESSFUL;
    KeSetEvent(&m_Hub->m_PnpEvent, IO_NO_INCREMENT, FALSE);
}

Referenced by FailStart().

◆ SmDereference()

VOID HubMachine::SmDereference ( )

private

Definition at line 281 of file hubsm.cpp.

{
    DereferenceHub();
}

◆ SmQueuePassive()

VOID HubMachine::SmQueuePassive ( )

private

Definition at line 287 of file hubsm.cpp.

{
    QueuePassiveWork();
}

◆ SmReference()

VOID HubMachine::SmReference ( )

private

Definition at line 275 of file hubsm.cpp.

{
    ReferenceHub();
}

◆ StartDescriptorRetryTimer()

VOID HubMachine::StartDescriptorRetryTimer ( )

private

Definition at line 1330 of file fdo.cpp.

{
    m_Hub->m_Timer.Start(HUB_DESCRIPTOR_RETRY_TIME);
}

Referenced by EnterAwaitingDescriptorRetry().

◆ StartDromOrSkip()

SM_RESULT HubMachine::StartDromOrSkip ( _In_ const State * Next )

private

Reads the router DROM through the vendor mailbox; no failure here fails the start.

Definition at line 473 of file hubsm.cpp.

{
    m_DromNext = Next;
 
    if (!IsDromReadWanted())
        return SmTransition(Next);
 
    m_DromPhase = DromPhase::Header;
    m_DromIndex = 0;
    m_DromWords = HubDromHeaderWords;
    UseDromHeaderBuffer();
 
    return SmTransition(&DromReadingFirstStatus);
}

Referenced by OnConfiguring(), and OnReconfiguring().

◆ StartDromWords()

SM_RESULT HubMachine::StartDromWords ( )

private

The DWORD count is rounded up from the total size, not from the length field.

Definition at line 600 of file hubsm.cpp.

{
    ULONG DataLength = DromDataLength();
    ULONG TotalBytes;
 
    if (DataLength < HubDromMinimumLength)
    {
        DPRINT1("Hub %p router DROM length %lu is too short\n", m_Hub, DataLength);
        return FinishDrom();
    }
 
    TotalBytes = DataLength + HubDromLengthBias;
    if (!AllocateDromBuffer(TotalBytes))
        return FinishDrom();
 
    m_DromPhase = DromPhase::Full;
    m_DromIndex = 0;
    m_DromWords = (TotalBytes + sizeof(ULONG) - 1) / sizeof(ULONG);
    return SmTransition(&DromWritingMetadata);
}

Referenced by StoreDromWordAndContinue().

◆ StartHubConfiguration()

SM_RESULT HubMachine::StartHubConfiguration ( )

private

Definition at line 406 of file hubsm.cpp.

{
    InitializeDescriptorRetries();
    return SmCall(&ReadingHubDescriptor);
}

Referenced by EnterConfiguring(), and EnterReconfiguring().

◆ StartPowerUp()

SM_RESULT HubMachine::StartPowerUp ( _In_ PowerUp Kind )

private

Definition at line 766 of file hubsm.cpp.

{
    switch (Kind)
    {
        case PowerUp::Resume:
            QueueResumeToPorts();
            break;
 
        case PowerUp::ResumeInS0:
            QueueResumeInS0ToPorts();
            break;
 
        case PowerUp::ResumeWithReset:
            LogResetOnResume();
            QueueResumeWithResetToPorts();
            break;
 
        default:
            AllowHubReset();
            QueueStartToPorts();
            break;
    }
 
    m_PowerUp = Kind;
    return SmTransition(&PortsAcquiring);
}

Referenced by CallHubDepthOr(), CheckPowerLoss(), OnAwaitingD0(), OnCheckingPowerLoss(), OnReconfiguringAfterReset(), OnReconfiguringAfterResume(), and OnSuspended().

◆ StartStatusChangeRead()

VOID HubMachine::StartStatusChangeRead ( )

private

Definition at line 705 of file hubreq.cpp.

{
    HubInterruptRequest* Interrupt = &m_Hub->m_Interrupt;
    WDF_REQUEST_REUSE_PARAMS Reuse;
    IO_STACK_LOCATION Stack;
    NTSTATUS Status;
 
    WDF_REQUEST_REUSE_PARAMS_INIT(&Reuse, WDF_REQUEST_REUSE_NO_FLAGS, STATUS_SUCCESS);
    WdfRequestReuse(Interrupt->Request, &Reuse);
 
    RtlZeroMemory(&Interrupt->Urb, sizeof(Interrupt->Urb));
    Interrupt->Urb.Hdr.Length = sizeof(Interrupt->Urb);
    Interrupt->Urb.Hdr.Function = URB_FUNCTION_BULK_OR_INTERRUPT_TRANSFER;
    Interrupt->Urb.Hdr.UsbdDeviceHandle = m_Hub->UsbDevice();
    Interrupt->Urb.TransferFlags = USBD_SHORT_TRANSFER_OK;
    if (m_Hub->NeedsForwardProgress())
        Interrupt->Urb.TransferFlags |= USB3_URB_RESERVED_RESOURCES;
 
    Interrupt->Urb.TransferBuffer = Interrupt->BitmapBuffer;
    Interrupt->Urb.TransferBufferLength = m_Hub->IsRootHub() ? Interrupt->BitmapMaxBytes : m_Hub->m_InterruptMaxPacket;
    Interrupt->Urb.PipeHandle = Interrupt->Pipe;
 
    if (Interrupt->LastInterruptWasEmpty)
    {
        Interrupt->Urb.Hdr.UsbdFlags |= UCXHUB_URB_FLAG_PEND_INTERRUPT_TX;
        Interrupt->LastInterruptWasEmpty = FALSE;
    }
 
    RtlZeroMemory(&Stack, sizeof(Stack));
    Stack.MajorFunction = IRP_MJ_INTERNAL_DEVICE_CONTROL;
    Stack.Parameters.DeviceIoControl.IoControlCode = IOCTL_INTERNAL_USB_SUBMIT_URB;
    Stack.Parameters.Others.Argument1 = &Interrupt->Urb;
    WdfRequestWdmFormatUsingStackLocation(Interrupt->Request, &Stack);
 
    WdfRequestSetCompletionRoutine(Interrupt->Request, HubInterruptComplete, m_Hub);
 
    if (WdfRequestSend(Interrupt->Request, WdfDeviceGetIoTarget(m_Hub->m_Device), WDF_NO_SEND_OPTIONS))
        return;
 
    /* A refused send with a success status posts nothing */
    Status = WdfRequestGetStatus(Interrupt->Request);
    WdfRequestReuse(Interrupt->Request, &Reuse);
 
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("Hub %p status change read not sent 0x%lx\n", m_Hub, Status);
        m_Hub->Post(HubEvent::InterruptFailed);
    }
}

Referenced by SendInterrupt().

◆ StoreDromWord()

VOID HubMachine::StoreDromWord ( _In_ ULONG Index )

private

Definition at line 189 of file hubdrom.cpp.

{
    NT_ASSERT(m_Hub->m_DromBuffer != NULL);
    m_Hub->m_DromBuffer[Index] = m_Hub->m_DromMailbox;
}

Referenced by StoreDromWordAndContinue().

◆ StoreDromWordAndContinue()

SM_RESULT HubMachine::StoreDromWordAndContinue ( )

private

Definition at line 640 of file hubsm.cpp.

{
    StoreDromWord(m_DromIndex);
    m_DromIndex += 1;
 
    if ((m_DromIndex < m_DromWords) && (m_DromIndex % HubMailboxDataWords) != 0)
        return SmTransition(&DromReadingWord);
 
    if (m_DromPhase == DromPhase::Header)
        return StartDromWords();
 
    if (m_DromIndex < m_DromWords)
        return SmTransition(&DromWritingMetadata);
 
    return FinishDrom();
}

Referenced by OnDromReadingWord().

◆ UpdateControllerHubInfo()

VOID HubMachine::UpdateControllerHubInfo ( )

private

Definition at line 421 of file ucxlink.cpp.

{
    WDF_OBJECT_ATTRIBUTES Attributes;
    PUSBDEVICE_HUB_INFO Payload;
    WDFMEMORY PayloadMemory;
    WDFREQUEST Request;
    ULONG Ports = m_Hub->m_PortCount;
 
    if (!NT_SUCCESS(HubCreateUcxRequest(m_Hub, m_Hub->m_RootHubTarget, &Request)))
    {
        m_Hub->Post(HubEvent::IoctlFailed);
        return;
    }
 
    WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
    Attributes.ParentObject = Request;
 
    if (!NT_SUCCESS(WdfMemoryCreate(&Attributes,
                                    NonPagedPool,
                                    HUB_TAG_HUB,
                                    sizeof(*Payload),
                                    &PayloadMemory,
                                    (PVOID*)&Payload)))
    {
        DPRINT1("Hub %p no memory for the UCX hub info request\n", m_Hub);
        WdfObjectDelete(Request);
        m_Hub->Post(HubEvent::IoctlFailed);
        return;
    }
 
    RtlZeroMemory(Payload, sizeof(*Payload));
    Payload->Header.Size = sizeof(*Payload);
    Payload->Header.Hub = m_Hub->UsbDevice();
    Payload->Header.UsbDevice = m_Hub->UsbDevice();
    Payload->NumberOfPorts = Ports;
 
    if (m_Hub->m_Parent.HubSpeed == UsbHighSpeed)
    {
        m_Hub->SetFlag(HubFlag::TtHub);
        Payload->NumberOfTTs = 1;
 
        if (m_Hub->m_ConfigDescriptor != NULL && HubHasMultiTtInterface(m_Hub->m_ConfigDescriptor))
        {
            m_Hub->SetFlag(HubFlag::MultiTtHub);
            Payload->NumberOfTTs = Ports;
        }
 
        Payload->TTThinkTime = (m_Hub->m_HubDescriptor.Usb20.wHubCharacteristics >> 5) & 0x3;
    }
 
    DPRINT("Hub %p telling UCX of %lu ports, %lu TTs\n", m_Hub, Ports, (ULONG)Payload->NumberOfTTs);
    HubSendUcxIoctl(m_Hub,
                    m_Hub->m_RootHubTarget,
                    IOCTL_UCXHUB_DEVICE_HUB_INFO,
                    Payload,
                    Request,
                    HubControllerHubInfoComplete);
}

Referenced by EnterUpdatingController().

◆ UseDromHeaderBuffer()

VOID HubMachine::UseDromHeaderBuffer ( )

private

Definition at line 150 of file hubdrom.cpp.

{
    RtlZeroMemory(m_Hub->m_DromHeader, sizeof(m_Hub->m_DromHeader));
    m_Hub->m_DromBuffer = m_Hub->m_DromHeader;
}

Referenced by StartDromOrSkip().

◆ WasResetByParent()

BOOLEAN HubMachine::WasResetByParent ( )

private

Definition at line 400 of file upstream.cpp.

{
    PVOID Context = m_Hub->m_Parent.Header.Context;
 
    if (!m_Hub->m_Parent.ParentResetDuringResume(Context))
        return FALSE;
 
    if (m_Hub->m_Parent.ParentLostStateDuringResume(Context))
    {
        DPRINT("Hub %p lost controller programming on resume\n", m_Hub);
        m_Hub->MarkDevicesProgrammingLost();
    }
 
    return TRUE;
}

Referenced by OnSuspended(), and OnSuspendedResetPending().

◆ WriteDromRegister()

VOID HubMachine::WriteDromRegister	(	_In_ USHORT	Register,
		_In_ ULONG	Value
	)

private

Definition at line 141 of file hubdrom.cpp.

{
    m_Hub->m_DromMailbox = Value;
    HubMailboxTransfer(m_Hub, TRUE, Register);
}

Referenced by EnterDromSendingCommand(), and EnterDromWritingMetadata().

Friends And Related Function Documentation

◆ SmMachine< HubMachine, HubEvent >

HubMachine::OnAwaitingD0

SM_RESULT OnAwaitingD0(_In_ HubEvent Event)

Definition: hubsm.cpp:444

Definition at line 160 of file hubsm.h.

Referenced by EnterQueryingErrata(), EnterReconfiguring(), and OnReconfiguring().

◆ AwaitingDescriptorRetry

const M::State M::AwaitingDescriptorRetry

staticprivate

Initial value:

=
    { NULL, "AwaitingDescriptorRetry", 0,
      &M::OnAwaitingDescriptorRetry, &M::EnterAwaitingDescriptorRetry }

Definition at line 202 of file hubsm.h.

Referenced by OnReadingHubDescriptor().

◆ AwaitingInterruptEnable

const M::State M::AwaitingInterruptEnable

staticprivate

Initial value:

=

{ NULL, "AwaitingInterruptEnable", 0, &M::OnAwaitingInterruptEnable, NULL }

HubMachine::OnAwaitingInterruptEnable

SM_RESULT OnAwaitingInterruptEnable(_In_ HubEvent Event)

Definition: hubsm.cpp:1211

Definition at line 180 of file hubsm.h.

Referenced by OnNotListening().

◆ AwaitingInterruptRefs

const M::State M::AwaitingInterruptRefs

staticprivate

Initial value:

=

{ NULL, "AwaitingInterruptRefs", 0, &M::OnAwaitingInterruptRefs, NULL }

HubMachine::OnAwaitingInterruptRefs

SM_RESULT OnAwaitingInterruptRefs(_In_ HubEvent Event)

Definition: hubsm.cpp:1201

Definition at line 179 of file hubsm.h.

Referenced by OnDrainingInterruptRefs(), and QuiesceWithoutInterrupt().

◆ AwaitingOverCurrentTimer

const M::State M::AwaitingOverCurrentTimer

staticprivate

Initial value:

=

{ NULL, "AwaitingOverCurrentTimer", 0, &M::OnAwaitingOverCurrentTimer, NULL }

HubMachine::OnAwaitingOverCurrentTimer

SM_RESULT OnAwaitingOverCurrentTimer(_In_ HubEvent Event)

Definition: hubsm.cpp:1089

Definition at line 175 of file hubsm.h.

Referenced by HandleHubChange().

◆ AwaitingReleaseAfterFailure

const M::State M::AwaitingReleaseAfterFailure

staticprivate

Initial value:

=

{ &Down, "AwaitingReleaseAfterFailure", 0, &M::OnAwaitingReleaseAfterFailure, NULL }

HubMachine::Down

static const State Down

Definition: hubsm.h:161

HubMachine::OnAwaitingReleaseAfterFailure

SM_RESULT OnAwaitingReleaseAfterFailure(_In_ HubEvent Event)

Definition: hubsm.cpp:720

Definition at line 164 of file hubsm.h.

Referenced by FailStart().

◆ AwaitingReleaseHardware

const M::State M::AwaitingReleaseHardware

staticprivate

Initial value:

=
    { &Down, "AwaitingReleaseHardware", 0, &M::OnAwaitingReleaseHardware,
      &M::EnterSignalPnp, ResetDiscards }

Definition at line 163 of file hubsm.h.

Referenced by OnDevicesReleasing(), and OnPortsReleasing().

◆ AwaitingResetRetry

const M::State M::AwaitingResetRetry

staticprivate

Initial value:

=

{ NULL, "AwaitingResetRetry", 0, &M::OnAwaitingResetRetry, NULL }

HubMachine::OnAwaitingResetRetry

SM_RESULT OnAwaitingResetRetry(_In_ HubEvent Event)

Definition: hubsm.cpp:1355

Definition at line 189 of file hubsm.h.

Referenced by EnterLoggingReset(), and OnHubResetting().

◆ AwaitingStop

const M::State M::AwaitingStop

staticprivate

Initial value:

=

{ &Down, "AwaitingStop", 0, &M::OnAwaitingStop, NULL, ResetDiscards }

HubMachine::OnAwaitingStop

SM_RESULT OnAwaitingStop(_In_ HubEvent Event)

Definition: hubsm.cpp:732

Definition at line 165 of file hubsm.h.

Referenced by EnterReportingFailure(), and OnRecycleSuspended().

◆ AwaitingStopAfterSuspend

const M::State M::AwaitingStopAfterSuspend

staticprivate

Initial value:

=

{ NULL, "AwaitingStopAfterSuspend", 0, &M::OnAwaitingStopAfterSuspend, NULL }

HubMachine::OnAwaitingStopAfterSuspend

SM_RESULT OnAwaitingStopAfterSuspend(_In_ HubEvent Event)

Definition: hubsm.cpp:1575

Definition at line 198 of file hubsm.h.

Referenced by OnAsleep().

◆ CancelingInterrupt

const M::State M::CancelingInterrupt

staticprivate

Initial value:

=

{ NULL, "CancelingInterrupt", 0, &M::OnCancelingInterrupt, NULL }

HubMachine::OnCancelingInterrupt

SM_RESULT OnCancelingInterrupt(_In_ HubEvent Event)

Definition: hubsm.cpp:1191

const M::State M::Down

staticprivate

Initial value:

=

{ NULL, "Down", HSM_REQ, &M::OnDown, NULL }

HubMachine::OnDown

SM_RESULT OnDown(_In_ HubEvent Event)

Definition: hubsm.cpp:674

Definition at line 161 of file hubsm.h.

◆ DrainingInterruptRefs

const M::State M::DrainingInterruptRefs

staticprivate

Initial value:

=

{ NULL, "DrainingInterruptRefs", 0, &M::OnDrainingInterruptRefs, NULL }

HubMachine::OnDrainingInterruptRefs

SM_RESULT OnDrainingInterruptRefs(_In_ HubEvent Event)

Definition: hubsm.cpp:1172

Definition at line 177 of file hubsm.h.

Referenced by QuiesceWithInterrupt().

◆ DromRead

const M::State M::DromRead

staticprivate

Initial value:

=

{ NULL, "DromRead", 0, &M::OnDromRead, NULL }

HubMachine::OnDromRead

SM_RESULT OnDromRead(_In_ HubEvent Event)

Definition: hubsm.cpp:490

Definition at line 153 of file hubsm.h.

◆ DromReadingFirstStatus

const M::State M::DromReadingFirstStatus

staticprivate

Initial value:

=
    { &DromRead, "DromReadingFirstStatus", HSM_PASSIVE,
      &M::OnDromReadingFirstStatus, &M::EnterDromReadingFirstStatus }

Definition at line 154 of file hubsm.h.

Referenced by StartDromOrSkip().

◆ DromReadingStatus

const M::State M::DromReadingStatus

staticprivate

Initial value:

=
    { &DromRead, "DromReadingStatus", HSM_PASSIVE,
      &M::OnDromReadingStatus, &M::EnterDromReadingStatus }

Definition at line 157 of file hubsm.h.

Referenced by CheckDromStatus(), and OnDromSendingCommand().

◆ DromReadingWord

const M::State M::DromReadingWord

staticprivate

Initial value:

=
    { &DromRead, "DromReadingWord", HSM_PASSIVE,
      &M::OnDromReadingWord, &M::EnterDromReadingWord }

Definition at line 158 of file hubsm.h.

Referenced by CheckDromStatus(), and StoreDromWordAndContinue().

◆ DromSendingCommand

const M::State M::DromSendingCommand

staticprivate

Initial value:

=
    { &DromRead, "DromSendingCommand", HSM_PASSIVE,
      &M::OnDromSendingCommand, &M::EnterDromSendingCommand }

Definition at line 156 of file hubsm.h.

Referenced by OnDromWritingMetadata().

◆ DromWritingMetadata

const M::State M::DromWritingMetadata

staticprivate

Initial value:

=
    { &DromRead, "DromWritingMetadata", HSM_PASSIVE,
      &M::OnDromWritingMetadata, &M::EnterDromWritingMetadata }

Definition at line 155 of file hubsm.h.

Referenced by OnDromReadingFirstStatus(), StartDromWords(), and StoreDromWordAndContinue().

◆ EventInfo

const SM_EVENT_INFO HubMachine::EventInfo

static

Definition at line 105 of file hubsm.h.

◆ FinishingConfiguration

const M::State M::FinishingConfiguration

staticprivate

Initial value:

=
    { NULL, "FinishingConfiguration", 0,
      &M::OnFinishingConfiguration, &M::EnterFinishingConfiguration }

Definition at line 207 of file hubsm.h.

Referenced by OnSettingConfiguration().

◆ Halted

const M::State M::Halted

staticprivate

Initial value:

=

{ NULL, "Halted", 0, NULL, &M::EnterHalted }

HubMachine::EnterHalted

SM_RESULT EnterHalted()

Definition: hubsm.cpp:1309

Definition at line 186 of file hubsm.h.

Referenced by EnterCheckingRecoveryLimit().

◆ HubResetting

const M::State M::HubResetting

staticprivate

Initial value:

=

{ NULL, "HubResetting", 0, &M::OnHubResetting, &M::EnterHubResetting, ResetDiscards }

HubMachine::OnHubResetting

SM_RESULT OnHubResetting(_In_ HubEvent Event)

Definition: hubsm.cpp:1325

HubMachine::EnterHubResetting

SM_RESULT EnterHubResetting()

Definition: hubsm.cpp:1318

Definition at line 187 of file hubsm.h.

Referenced by EnterCheckingRecoveryLimit(), OnAwaitingResetRetry(), and OnPortsResetting().

◆ Listening

const M::State M::Listening

staticprivate

Initial value:

=

{ NULL, "Listening", HSM_REQ, &M::OnListening, NULL }

HubMachine::OnListening

SM_RESULT OnListening(_In_ HubEvent Event)

Definition: hubsm.cpp:859

Definition at line 170 of file hubsm.h.

Referenced by OnListening(), and SendInterrupt().

◆ LoggingReset

const M::State M::LoggingReset

staticprivate

Initial value:

=

{ NULL, "LoggingReset", HSM_PASSIVE, NULL, &M::EnterLoggingReset }

HubMachine::EnterLoggingReset

staticprivate

Initial value:

=

{ NULL, "ProgrammingHubDepth", 0, &M::OnProgrammingHubDepth, &M::EnterProgrammingHubDepth }

HubMachine::OnProgrammingHubDepth

SM_RESULT OnProgrammingHubDepth(_In_ HubEvent Event)

Definition: hubsm.cpp:1847

HubMachine::EnterProgrammingHubDepth

SM_RESULT EnterProgrammingHubDepth()

Definition: hubsm.cpp:1840

Definition at line 215 of file hubsm.h.

Referenced by CallHubDepthOr(), and EnterFinishingConfiguration().

◆ QueryingErrata

const M::State M::QueryingErrata

staticprivate

Initial value:

=

{ NULL, "QueryingErrata", HSM_PASSIVE, NULL, &M::EnterQueryingErrata }

HubMachine::EnterQueryingErrata

SM_RESULT EnterQueryingErrata()

Definition: hubsm.cpp:426

Definition at line 159 of file hubsm.h.

Referenced by Initialize(), and OnConfiguring().

◆ QueryingParentInfo

const M::State M::QueryingParentInfo

staticprivate

Initial value:

=

{ NULL, "QueryingParentInfo", 0, &M::OnQueryingParentInfo, &M::EnterQueryingParentInfo }

HubMachine::EnterQueryingParentInfo

SM_RESULT EnterQueryingParentInfo()

Definition: hubsm.cpp:327

HubMachine::OnQueryingParentInfo

SM_RESULT OnQueryingParentInfo(_In_ HubEvent Event)

Definition: hubsm.cpp:334

Definition at line 150 of file hubsm.h.

Referenced by OnUnconfigured().

◆ ReadingConfigDescriptor

const M::State M::ReadingConfigDescriptor

staticprivate

Initial value:

=
    { NULL, "ReadingConfigDescriptor", 0,
      &M::OnReadingConfigDescriptor, &M::EnterReadingConfigDescriptor }

Definition at line 204 of file hubsm.h.

Referenced by OnReadingConfigDescriptor(), and OnReadingStandardStatus().

◆ ReadingHubDescriptor

const M::State M::ReadingHubDescriptor

staticprivate

Initial value:

=

{ NULL, "ReadingHubDescriptor", 0, &M::OnReadingHubDescriptor, &M::EnterReadingHubDescriptor }

HubMachine::EnterReadingHubDescriptor

SM_RESULT EnterReadingHubDescriptor()

Definition: hubsm.cpp:1587

HubMachine::OnReadingHubDescriptor

SM_RESULT OnReadingHubDescriptor(_In_ HubEvent Event)

Definition: hubsm.cpp:1594

Definition at line 201 of file hubsm.h.

Referenced by OnAwaitingDescriptorRetry(), and StartHubConfiguration().

◆ ReadingHubStatus

const M::State M::ReadingHubStatus

staticprivate

Initial value:

=

{ NULL, "ReadingHubStatus", 0, &M::OnReadingHubStatus, NULL }

HubMachine::OnReadingHubStatus

SM_RESULT OnReadingHubStatus(_In_ HubEvent Event)

Definition: hubsm.cpp:987

Definition at line 173 of file hubsm.h.

Referenced by ReadStatus().

◆ ReadingPortStatus

const M::State M::ReadingPortStatus

staticprivate

Initial value:

=

{ NULL, "ReadingPortStatus", HSM_CRIT, &M::OnReadingPortStatus, NULL }

HubMachine::OnReadingPortStatus

SM_RESULT OnReadingPortStatus(_In_ HubEvent Event)

Definition: hubsm.cpp:947

HSM_CRIT

#define HSM_CRIT

Definition: hubsm.cpp:81

Definition at line 172 of file hubsm.h.

Referenced by ReadPortStatus().

◆ ReadingRootHub20Ports

const M::State M::ReadingRootHub20Ports

staticprivate

Initial value:

=
    { NULL, "ReadingRootHub20Ports", 0,
      &M::OnReadingRootHub20Ports, &M::EnterReadingRootHub20Ports }

Definition at line 211 of file hubsm.h.

Referenced by OnReadingRootHubInfo().

◆ ReadingRootHub30Ports

const M::State M::ReadingRootHub30Ports

staticprivate

Initial value:

=
    { NULL, "ReadingRootHub30Ports", 0,
      &M::OnReadingRootHub30Ports, &M::EnterReadingRootHub30Ports }

Definition at line 212 of file hubsm.h.

Referenced by OnReadingRootHub20Ports().

◆ ReadingRootHubInfo

const M::State M::ReadingRootHubInfo

staticprivate

Initial value:

=

{ NULL, "ReadingRootHubInfo", 0, &M::OnReadingRootHubInfo, &M::EnterReadingRootHubInfo }

HubMachine::EnterReadingRootHubInfo

SM_RESULT EnterReadingRootHubInfo()

Definition: hubsm.cpp:1765

HubMachine::OnReadingRootHubInfo

SM_RESULT OnReadingRootHubInfo(_In_ HubEvent Event)

Definition: hubsm.cpp:1773

Definition at line 210 of file hubsm.h.

Referenced by EnterConfiguring().

◆ ReadingStandardStatus

const M::State M::ReadingStandardStatus

staticprivate

Initial value:

=
    { NULL, "ReadingStandardStatus", 0,
      &M::OnReadingStandardStatus, &M::EnterReadingStandardStatus }

Definition at line 203 of file hubsm.h.

Referenced by OnReadingHubDescriptor().

◆ Reconfiguring

const M::State M::Reconfiguring

staticprivate

Initial value:

=

{ NULL, "Reconfiguring", 0, &M::OnReconfiguring, &M::EnterReconfiguring }

HubMachine::EnterReconfiguring

SM_RESULT EnterReconfiguring()

Definition: hubsm.cpp:379

HubMachine::OnReconfiguring

SM_RESULT OnReconfiguring(_In_ HubEvent Event)

Definition: hubsm.cpp:388

Definition at line 152 of file hubsm.h.

Referenced by OnStopped().

◆ ReconfiguringAfterReset

const M::State M::ReconfiguringAfterReset

staticprivate

Initial value:

=
    { NULL, "ReconfiguringAfterReset", HSM_PASSIVE,
      &M::OnReconfiguringAfterReset, &M::EnterReconfiguringAfterReset }

Definition at line 190 of file hubsm.h.

Referenced by OnHubResetting().

◆ ReconfiguringAfterResume

const M::State M::ReconfiguringAfterResume

staticprivate

Initial value:

=
    { NULL, "ReconfiguringAfterResume", 0,
      &M::OnReconfiguringAfterResume, &M::EnterReconfiguringAfterResume }

Definition at line 192 of file hubsm.h.

Referenced by OnResettingOnResume(), and OnSuspended().

◆ RecycleSuspended

const M::State M::RecycleSuspended

staticprivate

Initial value:

=

{ &Asleep, "RecycleSuspended", 0, &M::OnRecycleSuspended, NULL }

HubMachine::Asleep

static const State Asleep

Definition: hubsm.h:194

HubMachine::OnRecycleSuspended

SM_RESULT OnRecycleSuspended(_In_ HubEvent Event)

Definition: hubsm.cpp:1544

Definition at line 196 of file hubsm.h.

Referenced by OnAwaitingStop().

◆ ReportingFailure

const M::State M::ReportingFailure

staticprivate

Initial value:

=

const M::State M::SuspendedResetPending

staticprivate

Initial value:

=
    { &Asleep, "SuspendedResetPending", 0,
      &M::OnSuspendedResetPending, &M::EnterSuspendedResetPending }

Definition at line 197 of file hubsm.h.

Referenced by OnSuspended().

◆ Unconfigured

const M::State M::Unconfigured

staticprivate

Initial value:

=

{ NULL, "Unconfigured", HSM_REQ, &M::OnUnconfigured, NULL }

HubMachine::OnUnconfigured

SM_RESULT OnUnconfigured(_In_ HubEvent Event)

Definition: hubsm.cpp:306

Definition at line 149 of file hubsm.h.

Referenced by OnAwaitingAddDevice(), and OnAwaitingReleaseAfterFailure().

◆ UpdatingController

const M::State M::UpdatingController

staticprivate

Initial value:

=

{ NULL, "UpdatingController", 0, &M::OnUpdatingController, &M::EnterUpdatingController }

HubMachine::OnUpdatingController

SM_RESULT OnUpdatingController(_In_ HubEvent Event)

Definition: hubsm.cpp:1703

HubMachine::EnterUpdatingController

SM_RESULT EnterUpdatingController()

Definition: hubsm.cpp:1696

Definition at line 205 of file hubsm.h.

Referenced by OnReadingConfigDescriptor().

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

drivers/usb/usbhub3/hubsm.h
drivers/usb/usbhub3/fanout.cpp
drivers/usb/usbhub3/fdo.cpp
drivers/usb/usbhub3/hubdrom.cpp
drivers/usb/usbhub3/hubregistry.cpp
drivers/usb/usbhub3/hubreq.cpp
drivers/usb/usbhub3/hubsm.cpp
drivers/usb/usbhub3/ucxlink.cpp
drivers/usb/usbhub3/upstream.cpp

Public Member Functions

Static Public Attributes

Private Types

Private Member Functions

Private Attributes

Static Private Attributes

Friends

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ DromPhase

◆ PowerUp

◆ StatusRead

◆ Teardown

Member Function Documentation

◆ AckHubChange()

◆ AcquirePowerReference()

◆ AfterInterruptQuiet()

◆ AllocateDromBuffer()

◆ AllowHubReset()

◆ ArmOverCurrentTimer()

◆ ArmResetRetryTimer()

◆ BugcheckBootHub()

◆ CacheConfigDescriptor()

◆ CallHubDepthOr()

◆ CancelStatusChangeRead()

◆ CheckDromStatus()

◆ CheckHubChangeBit()

◆ CheckPowerLoss()

◆ ClearPipeResetCount()

◆ ConfigDescriptorTruncated()

◆ CreateChildPorts()

◆ DereferenceHub()

◆ DescriptorRetriesExhausted()

◆ DromDataLength()

◆ EnterAwaitingDescriptorRetry()

◆ EnterCheckingRecoveryLimit()

◆ EnterConfiguring()

◆ EnterDromReadingFirstStatus()

◆ EnterDromReadingStatus()

◆ EnterDromReadingWord()

◆ EnterDromSendingCommand()

◆ EnterDromWritingMetadata()

◆ EnterFinishingConfiguration()

◆ EnterHalted()

◆ EnterHubResetting()

◆ EnterLoggingReset()

◆ EnterProgrammingHubDepth()

◆ EnterQueryingErrata()

◆ EnterQueryingParentInfo()

◆ EnterReadingConfigDescriptor()

◆ EnterReadingHubDescriptor()

◆ EnterReadingRootHub20Ports()

◆ EnterReadingRootHub30Ports()

◆ EnterReadingRootHubInfo()

◆ EnterReadingStandardStatus()

◆ EnterReconfiguring()

◆ EnterReconfiguringAfterReset()

◆ EnterReconfiguringAfterResume()

◆ EnterReportingFailure()

◆ EnterSettingConfiguration()

◆ EnterSignalPnp()

◆ EnterSuspendedResetPending()

◆ EnterUpdatingController()

◆ FailPortStatus()

◆ FailStart()

◆ FinishDrom()

◆ GetConfigDescriptor()

◆ GetHubDescriptor()

◆ GetHubStatus()

◆ GetParentInfo()

◆ GetPortStatus()

◆ GetRootHub20Ports()

◆ GetRootHub30Ports()

◆ GetRootHubInfo()

◆ GetStandardStatus()

◆ HandleHubChange()

◆ HandleHubStatusFault()

◆ Hub()

◆ Initialize()