hubwmi.cpp File Reference

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

Include dependency graph for hubwmi.cpp:

Go to the source code of this file.

Macros
#define	NDEBUG
#define	HUB_WMI_MIN_ACQUIRE_SIZE   10
#define	HUB_WMI_FIELD(Info, Field)    ((PUCHAR)(Info) + FIELD_OFFSET(USB_DEVICE_NODE_INFO, Field))

Functions
	C_ASSERT (sizeof(USB_CONNECTION_NOTIFICATION)==24)
	C_ASSERT (sizeof(USB_BUS_NOTIFICATION)==16)
	C_ASSERT (FIELD_OFFSET(USB_ACQUIRE_INFO, Buffer)==8)
	C_ASSERT (sizeof(USB_PIPE_INFO)==11)
	C_ASSERT (sizeof(USB_HUB_PORT_INFORMATION)==16)
	C_ASSERT (sizeof(USB_DEVICE_NODE_INFO)==1202)
	C_ASSERT (FIELD_OFFSET(USB_DEVICE_NODE_INFO, UsbDeviceInfo.PipeList)==1191)
	C_ASSERT (FIELD_OFFSET(USB_DEVICE_NODE_INFO, HubDeviceInfo.PortInfo)==211)
static PCWSTR NTAPI	HubWmiHubName (_In_ HubFdo *Hub, _Out_ PULONG Length)
static VOID NTAPI	HubWmiFirePortEvent (_In_ HubFdo *Hub, _In_ ULONG PortNumber, _In_ USB_NOTIFICATION_TYPE Type)
	_IRQL_requires_ (PASSIVE_LEVEL) static NTSTATUS NTAPI HubWmiCreateInstance(_In_ WDFDEVICE Device
	Sends a synchronous IOCTL to the specified device object.
return	WdfWmiInstanceCreate (Device, &Config, Attributes, Instance)
VOID NTAPI	HubMakeUsb2StyleDescriptor (_In_ HubFdo *Hub, _Out_ PUSB_HUB_DESCRIPTOR Descriptor)
	WdfFdoLockStaticChildListForIteration (Hub->m_Device)
	while ((Child=WdfFdoRetrieveNextStaticChild(Hub->m_Device, Child, WdfRetrievePresentChildren)) !=NULL)
	WdfFdoUnlockStaticChildListFromIteration (Hub->m_Device)
static NTSTATUS NTAPI	HubWmiQueryHubNode (_In_ WDFWMIINSTANCE WmiInstance, _In_ ULONG OutBufferSize, _Out_writes_bytes_to_(OutBufferSize, *BufferUsed) PVOID OutBuffer, _Out_ PULONG BufferUsed)
_In_ DEVICE_REGISTRY_PROPERTY	_Out_writes_bytes_ (Size) PUCHAR Destination
	if (!NT_SUCCESS(WdfDeviceAllocAndQueryProperty(Device, Property, NonPagedPool, &Attributes, &Memory))) return
	RtlCopyMemory (Destination, Data, min(Length,(size_t) Size))
	WdfObjectDelete (Memory)
static VOID NTAPI	HubWmiCopyPipes (_In_ HubConfiguration *Config, _Out_ PUSB_PIPE_INFO Pipes)
static NTSTATUS NTAPI	HubWmiQueryDeviceNode (_In_ WDFWMIINSTANCE WmiInstance, _In_ ULONG OutBufferSize, _Out_writes_bytes_to_(OutBufferSize, *BufferUsed) PVOID OutBuffer, _Out_ PULONG BufferUsed)
static NTSTATUS NTAPI	HubWmiResetOverCurrent (_In_ HubFdo *Hub, _In_ PUSB_CONNECTION_NOTIFICATION Request)
	if (OutBufferSize< sizeof(*Notification))
	if (!NT_SUCCESS(Status))
static BOOLEAN NTAPI	HubWmiAcquireSizeValid (_In_ PUSB_ACQUIRE_INFO Request, _In_ ULONG OutBufferSize)
static NTSTATUS NTAPI	HubWmiHubNameRequest (_In_ HubFdo *Hub, _In_ ULONG OutBufferSize, _Inout_ PUSB_ACQUIRE_INFO Request, _Out_ PULONG BufferUsed)
	if (!HubWmiAcquireSizeValid(Request, OutBufferSize)) return STATUS_BUFFER_TOO_SMALL
static NTSTATUS NTAPI	HubWmiExecuteMethod (_In_ WDFWMIINSTANCE WmiInstance, _In_ ULONG MethodId, _In_ ULONG InBufferSize, _In_ ULONG OutBufferSize, _Inout_ PVOID Buffer, _Out_ PULONG BufferUsed)
static VOID NTAPI	HubWmiEvtSurpriseRemovalCleanup (_In_ WDFOBJECT Object)
VOID NTAPI	HubWmiNotifyOverCurrent (_In_ HubFdo *Hub, _In_ ULONG PortNumber)
	_IRQL_requires_max_ (DISPATCH_LEVEL) VOID NTAPI HubWmiNotifyEnumerationFailure(_In_ HubFdo *Hub

Variables
static const GUID	HubWmiSurpriseRemovalGuid
static KSPIN_LOCK	HubWmiSurpriseLock
_In_ const GUID *	Guid
_In_ const GUID _In_ ULONG	ProviderFlags
_In_ const GUID _In_ ULONG _In_opt_ PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE	Query
_In_ const GUID _In_ ULONG _In_opt_ PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE _In_opt_ PFN_WDF_WMI_INSTANCE_EXECUTE_METHOD	Method
_In_ const GUID _In_ ULONG _In_opt_ PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE _In_opt_ PFN_WDF_WMI_INSTANCE_EXECUTE_METHOD _In_opt_ PWDF_OBJECT_ATTRIBUTES	Attributes
_In_ const GUID _In_ ULONG _In_opt_ PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE _In_opt_ PFN_WDF_WMI_INSTANCE_EXECUTE_METHOD _In_opt_ PWDF_OBJECT_ATTRIBUTES _Out_opt_ WDFWMIINSTANCE *	Instance
WDF_WMI_INSTANCE_CONFIG	Config
WDF_WMI_PROVIDER_CONFIG_INIT &	Provider
Provider	Flags = ProviderFlags
Config	Register = TRUE
Config	EvtWmiInstanceQueryInstance = Query
Config	EvtWmiInstanceExecuteMethod = Method
_In_ HubPort *	Port
_In_ HubPort _In_ USHORT	PortNumber
_In_ HubPort _In_ USHORT _Out_ PUSHORT	DeviceAddress
HubPdo *	Pdo
return Port	m_ConnectionStatus
_In_ DEVICE_REGISTRY_PROPERTY	Property
_In_ DEVICE_REGISTRY_PROPERTY _In_ ULONG	Size
WDFMEMORY	Memory
size_t	Length
PVOID	Data = WdfMemoryGetBuffer(Memory, &Length)
Attributes	ParentObject = Device
_In_ ULONG	OutBufferSize
_In_ ULONG _Inout_ PUSB_BUS_NOTIFICATION	Notification
_In_ ULONG _Inout_ PUSB_BUS_NOTIFICATION _Out_ PULONG	BufferUsed
NTSTATUS	Status = HubQueryControllerName(Hub, &Name, sizeof(Name))
Name	ActualLength = 0
Name	HubName [0] = UNICODE_NULL
Notification	TotalBandwidth = 0
Notification	ConsumedBandwidth = 0
Notification	ControllerNameLength = Name.ActualLength
return	STATUS_SUCCESS
_In_ ULONG _Inout_ PUSB_ACQUIRE_INFO	Request
ULONG	Total = Request->TotalSize
Request	TotalSize = Total - sizeof(ULONG)

Macro Definition Documentation

HUB_WMI_FIELD

#define HUB_WMI_FIELD	(		Info,
			Field
	)		((PUCHAR)(Info) + FIELD_OFFSET(USB_DEVICE_NODE_INFO, Field))

Definition at line 31 of file hubwmi.cpp.

HUB_WMI_MIN_ACQUIRE_SIZE

#define HUB_WMI_MIN_ACQUIRE_SIZE   10

Definition at line 28 of file hubwmi.cpp.

NDEBUG

#define NDEBUG

Definition at line 10 of file hubwmi.cpp.

Function Documentation

_IRQL_requires_()

_IRQL_requires_

(

PASSIVE_LEVEL

)

Sends a synchronous IOCTL to the specified device object.

Copies up to Size bytes of a device property; a failed query leaves the field zero.

Only the controller name length is real; both bandwidth fields read 0.

The answer overlays a USB_HUB_NAME on TotalSize, so TotalSize comes back as the name length + 4.

Definition at line 621 of file hubwmi.cpp.

{
    WDFWMIINSTANCE Instance;
    NTSTATUS Status;
 
    /* Runs on every start; earlier instances stay registered */
    Status = HubWmiCreateInstance(Hub->m_Device,
                                  &GUID_USB_WMI_STD_DATA,
                                  0,
                                  NULL,
                                  HubWmiExecuteMethod,
                                  WDF_NO_OBJECT_ATTRIBUTES,
                                  &Instance);
    if (NT_SUCCESS(Status))
        Hub->m_WmiInstance = Instance;
    else
        DPRINT1("Hub %p: WMI notification provider failed 0x%lx\n", Hub, Status);
 
    Status = HubWmiCreateInstance(Hub->m_Device,
                                  &GUID_USB_WMI_NODE_INFO,
                                  0,
                                  HubWmiQueryHubNode,
                                  NULL,
                                  WDF_NO_OBJECT_ATTRIBUTES,
                                  NULL);
    if (!NT_SUCCESS(Status))
        DPRINT1("Hub %p: WMI node info provider failed 0x%lx\n", Hub, Status);
}

_IRQL_requires_max_()

_IRQL_requires_max_

(

DISPATCH_LEVEL

)

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION; the idle machine owns the IRP afterwards.

Records hub over current in the hub hardware key, once per devnode.

First selective suspend of the device; the registry write runs in a work item.

"USB device not recognized" popup for a port.

A hub was attached beyond the allowed tier depth.

The selected configuration draws more power than the port can give.

The controller ran out of bandwidth for the device; fired by the out of bandwidth timer.

Definition at line 77 of file common.c.

{
    NTSTATUS                    status;
    BOOLEAN                     requestSent = FALSE;
 
    BOOLEAN                     shouldRetry = TRUE;
    PCDB                        cdb = (PCDB)DeviceExtension->PowerContext.Srb.Cdb;
    ULONG                       timeoutValue = DeviceExtension->TimeOutValue;
    ULONG                       retryCount = 1;
 
    // reset some fields.
    DeviceExtension->PowerContext.RetryIntervalIn100ns = 0;
    status = PowerContextReuseRequest(DeviceExtension);
    RequestClearSendTime(DeviceExtension->PowerContext.PowerRequest);
 
    if (!NT_SUCCESS(status))
    {
        return status;
    }
 
    // set proper timeout value and max retry count.
    switch(DeviceExtension->PowerContext.PowerChangeState.PowerDown)
    {
    case PowerDownDeviceInitial:
    case PowerDownDeviceQuiesced:
    case PowerDownDeviceStopped:
        break;
 
    case PowerDownDeviceLocked:
        // Case of issuing SYNC CACHE command. Do not use power irp timeout remaining time in this case
        // as we want to give best try on SYNC CACHE command.
        retryCount = MAXIMUM_RETRIES;
        timeoutValue = DeviceExtension->TimeOutValue;
        break;
 
    case PowerDownDeviceFlushed:
    {
        // Case of issuing STOP UNIT command
        // As "Imme" bit is set to '1', this command should be completed in short time.
        // This command is at low importance, failure of this command has very small impact.
        ULONG secondsRemaining = 0;
 
#if (WINVER >= 0x0601)
        // this API is introduced in Windows7
        PoQueryWatchdogTime(DeviceExtension->LowerPdo, &secondsRemaining);
#endif
 
        if (secondsRemaining == 0)
        {
            // not able to retrieve remaining time from PoQueryWatchdogTime API, use default values.
            retryCount = MAXIMUM_RETRIES;
            timeoutValue = SCSI_CDROM_TIMEOUT;
        }
        else
        {
            // plan to leave about 30 seconds to lower level drivers if possible.
            if (secondsRemaining >= 32)
            {
                retryCount = (secondsRemaining - 30)/SCSI_CDROM_TIMEOUT + 1;
                timeoutValue = SCSI_CDROM_TIMEOUT;
 
                if (retryCount > MAXIMUM_RETRIES)
                {
                    retryCount = MAXIMUM_RETRIES;
                }
 
                if (retryCount == 1)
                {
                    timeoutValue = secondsRemaining - 30;
                }
            }
            else
            {
                // issue the command with minimal timeout value and do not retry on it.
                retryCount = 1;
                timeoutValue = 2;
            }
        }
    }
        break;
    default:
        NT_ASSERT( FALSE );
        status = STATUS_NOT_IMPLEMENTED;
        return status;
    }
 
    DeviceExtension->PowerContext.RetryCount = retryCount;
 
    // issue command.
    while (shouldRetry)
    {
 
        // set SRB fields.
        DeviceExtension->PowerContext.Srb.SrbFlags = SRB_FLAGS_NO_DATA_TRANSFER |
                                                     SRB_FLAGS_DISABLE_SYNCH_TRANSFER |
                                                     SRB_FLAGS_NO_QUEUE_FREEZE |
                                                     SRB_FLAGS_BYPASS_LOCKED_QUEUE |
                                                     SRB_FLAGS_D3_PROCESSING;
 
        DeviceExtension->PowerContext.Srb.Function = SRB_FUNCTION_EXECUTE_SCSI;
        DeviceExtension->PowerContext.Srb.TimeOutValue = timeoutValue;
 
        if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceInitial)
        {
            DeviceExtension->PowerContext.Srb.Function = SRB_FUNCTION_LOCK_QUEUE;
        }
        else if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceLocked)
        {
            DeviceExtension->PowerContext.Srb.Function = SRB_FUNCTION_QUIESCE_DEVICE;
        }
        else if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceQuiesced)
        {
            // Case of issuing SYNC CACHE command.
            DeviceExtension->PowerContext.Srb.CdbLength = 10;
            cdb->SYNCHRONIZE_CACHE10.OperationCode = SCSIOP_SYNCHRONIZE_CACHE;
        }
        else if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceFlushed)
        {
            // Case of issuing STOP UNIT command.
            DeviceExtension->PowerContext.Srb.CdbLength = 6;
            cdb->START_STOP.OperationCode = SCSIOP_START_STOP_UNIT;
            cdb->START_STOP.Start = 0;
            cdb->START_STOP.Immediate = 1;
        }
        else if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceStopped)
        {
            DeviceExtension->PowerContext.Srb.Function = SRB_FUNCTION_UNLOCK_QUEUE;
        }
 
        // Set up completion routine and context if requested
        if (CompletionRoutine)
        {
            WdfRequestSetCompletionRoutine(DeviceExtension->PowerContext.PowerRequest,
                                           CompletionRoutine,
                                           Context);
        }
 
        status = RequestSend(DeviceExtension,
                             DeviceExtension->PowerContext.PowerRequest,
                             DeviceExtension->IoTarget,
                             CompletionRoutine ? 0 : WDF_REQUEST_SEND_OPTION_SYNCHRONOUS,
                             &requestSent);
 
        if (requestSent)
        {
            if ((CompletionRoutine == NULL) &&
                (SRB_STATUS(DeviceExtension->PowerContext.Srb.SrbStatus) != SRB_STATUS_SUCCESS))
            {
                TracePrint((TRACE_LEVEL_ERROR,
                            TRACE_FLAG_POWER,
                            "%p\tError occured when issuing %s command to device. Srb %p, Status %x\n",
                            DeviceExtension->PowerContext.PowerRequest,
                            (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceQuiesced) ? "SYNC CACHE" : "STOP UNIT",
                            &DeviceExtension->PowerContext.Srb,
                            DeviceExtension->PowerContext.Srb.SrbStatus));
 
                NT_ASSERT(!(TEST_FLAG(DeviceExtension->PowerContext.Srb.SrbStatus, SRB_STATUS_QUEUE_FROZEN)));
 
                shouldRetry = RequestSenseInfoInterpret(DeviceExtension,
                                                        DeviceExtension->PowerContext.PowerRequest,
                                                        &(DeviceExtension->PowerContext.Srb),
                                                        retryCount - DeviceExtension->PowerContext.RetryCount,
                                                        &status,
                                                        &(DeviceExtension->PowerContext.RetryIntervalIn100ns));
 
                if (shouldRetry && (DeviceExtension->PowerContext.RetryCount-- == 0))
                {
                    shouldRetry = FALSE;
                }
            }
            else
            {
                // succeeded, do not need to retry.
                shouldRetry = FALSE;
            }
 
        }
        else
        {
            // request failed to be sent
            shouldRetry = FALSE;
        }
 
        if (shouldRetry)
        {
            LARGE_INTEGER t;
            t.QuadPart = -DeviceExtension->PowerContext.RetryIntervalIn100ns;
            KeDelayExecutionThread(KernelMode, FALSE, &t);
 
            status = PowerContextReuseRequest(DeviceExtension);
            if (!NT_SUCCESS(status))
            {
                shouldRetry = FALSE;
            }
        }
    }
 
    if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceQuiesced)
    {
        // record SYNC CACHE command completion time stamp.
        KeQueryTickCount(&DeviceExtension->PowerContext.Step1CompleteTime);
    }
 
    return status;
}

_Out_writes_bytes_()

_In_ DEVICE_REGISTRY_PROPERTY _Out_writes_bytes_

(

Size

)

Definition at line 35 of file hubregistry.cpp.

{
    UNICODE_STRING ValueName;
 
    RtlZeroMemory(Data, Size);
    RtlInitUnicodeString(&ValueName, Name);
 
    return WdfRegistryQueryValue(Key, &ValueName, Size, Data, NULL, NULL);
}

C_ASSERT() [1/8]

C_ASSERT

(

FIELD_OFFSET(USB_ACQUIRE_INFO, Buffer)

= =8

)

C_ASSERT() [2/8]

C_ASSERT

(

FIELD_OFFSET(USB_DEVICE_NODE_INFO, HubDeviceInfo.PortInfo)

= =211

)

C_ASSERT() [3/8]

C_ASSERT

(

FIELD_OFFSET(USB_DEVICE_NODE_INFO, UsbDeviceInfo.PipeList)

= =1191

)

C_ASSERT() [4/8]

C_ASSERT

(

sizeof(USB_BUS_NOTIFICATION)

= =16

)

C_ASSERT() [5/8]

C_ASSERT

(

sizeof(USB_CONNECTION_NOTIFICATION)

= =24

)

C_ASSERT() [6/8]

C_ASSERT

(

sizeof(USB_DEVICE_NODE_INFO)

= =1202

)

C_ASSERT() [7/8]

C_ASSERT

(

sizeof(USB_HUB_PORT_INFORMATION)

= =16

)

C_ASSERT() [8/8]

C_ASSERT

(

sizeof(USB_PIPE_INFO)

= =11

)

HubMakeUsb2StyleDescriptor()

VOID NTAPI HubMakeUsb2StyleDescriptor	(	_In_ HubFdo *	Hub,
		_Out_ PUSB_HUB_DESCRIPTOR	Descriptor
	)

The 71 byte USB 2.0 style hub descriptor legacy tools expect, for any hub speed.

Definition at line 135 of file hubwmi.cpp.

{
    ULONG MaskBytes;
 
    RtlZeroMemory(Descriptor, sizeof(*Descriptor));
 
    if (Hub->IsRootHub())
    {
        Descriptor->bPowerOnToPowerGood = 2;
    }
    else if (Hub->m_Parent.HubSpeed == UsbHighSpeed || Hub->m_Parent.HubSpeed == UsbFullSpeed)
    {
        RtlCopyMemory(Descriptor, &Hub->m_HubDescriptor.Usb20, sizeof(*Descriptor));
        return;
    }
    else if (Hub->m_Parent.HubSpeed == UsbSuperSpeed)
    {
        Descriptor->wHubCharacteristics = Hub->m_HubDescriptor.Usb30.wHubCharacteristics & 0x1F;
        Descriptor->bPowerOnToPowerGood = Hub->m_HubDescriptor.Usb30.bPowerOnToPowerGood;
        Descriptor->bHubControlCurrent = Hub->m_HubDescriptor.Usb30.bHubControlCurrent;
    }
    else
    {
        /* A low speed hub cannot exist */
        return;
    }
 
    /* Always 9, even when more than 7 ports need a longer mask */
    Descriptor->bDescriptorLength = 9;
    Descriptor->bDescriptorType = USB_20_HUB_DESCRIPTOR_TYPE;
    Descriptor->bNumberOfPorts = (UCHAR)Hub->m_PortCount;
 
    /* All ports removable, followed by an all ones power control mask */
    MaskBytes = Descriptor->bNumberOfPorts / 8 + 1;
    RtlFillMemory(&Descriptor->bRemoveAndPowerMask[MaskBytes], MaskBytes, 0xFF);
}

Referenced by HubWmiQueryHubNode().

HubWmiAcquireSizeValid()

static BOOLEAN NTAPI HubWmiAcquireSizeValid ( _In_ PUSB_ACQUIRE_INFO  Request, _In_ ULONG  OutBufferSize  )

static

Definition at line 489 of file hubwmi.cpp.

{
    if (OutBufferSize >= HUB_WMI_MIN_ACQUIRE_SIZE &&
        Request->TotalSize >= HUB_WMI_MIN_ACQUIRE_SIZE &&
        Request->TotalSize <= OutBufferSize)
    {
        return TRUE;
    }
 
    DPRINT1("WMI name request size %lu does not fit buffer of %lu bytes\n",
            (OutBufferSize >= HUB_WMI_MIN_ACQUIRE_SIZE) ? Request->TotalSize : 0, OutBufferSize);
    return FALSE;
}

Referenced by HubWmiHubNameRequest().

HubWmiCopyPipes()

static VOID NTAPI HubWmiCopyPipes ( _In_ HubConfiguration *  Config, _Out_ PUSB_PIPE_INFO  Pipes  )

static

Endpoints of the current configuration, listed only when the first interface owns all of them.

Definition at line 302 of file hubwmi.cpp.

{
    HubInterface* Interface;
    ULONG Index;
 
    if (IsListEmpty(&Config->Interfaces))
        return;
 
    Interface = CONTAINING_RECORD(Config->Interfaces.Flink, HubInterface, Link);
    if (Interface->PipeCount != Config->EndpointCount)
        return;
 
    for (Index = 0; Index < Interface->PipeCount; Index++)
        Pipes[Index].EndpointDescriptor = *Interface->Pipes[Index].Descriptor;
}

Referenced by HubWmiQueryDeviceNode().

HubWmiEvtSurpriseRemovalCleanup()

static VOID NTAPI HubWmiEvtSurpriseRemovalCleanup ( _In_ WDFOBJECT  Object )

static

Clears the driver wide handle along with its instance.

Definition at line 677 of file hubwmi.cpp.

{
    HubSpinLockGuard Guard(&HubWmiSurpriseLock);
 
    if (HubDriver.SurpriseRemovalWmi == (WDFWMIINSTANCE)Object)
        HubDriver.SurpriseRemovalWmi = NULL;
}

HubWmiExecuteMethod()

static NTSTATUS NTAPI HubWmiExecuteMethod ( _In_ WDFWMIINSTANCE  WmiInstance, _In_ ULONG  MethodId, _In_ ULONG  InBufferSize, _In_ ULONG  OutBufferSize, _Inout_ PVOID  Buffer, _Out_ PULONG  BufferUsed  )

static

Dispatches on the request's notification type; MethodId and InBufferSize are ignored.

Definition at line 573 of file hubwmi.cpp.

{
    HubFdo* Hub;
 
    UNREFERENCED_PARAMETER(MethodId);
    UNREFERENCED_PARAMETER(InBufferSize);
 
    *BufferUsed = 0;
    if (OutBufferSize < sizeof(USB_NOTIFICATION))
    {
        DPRINT1("WMI method buffer of %lu bytes too small\n", OutBufferSize);
        return STATUS_BUFFER_TOO_SMALL;
    }
 
    Hub = HubFdo::FromDevice(WdfWmiInstanceGetDevice(WmiInstance));
 
    switch (((PUSB_NOTIFICATION)Buffer)->NotificationType)
    {
        case ResetOvercurrent:
            if (OutBufferSize < sizeof(USB_CONNECTION_NOTIFICATION))
            {
                DPRINT1("Hub %p over current reset buffer of %lu bytes too small\n", Hub, OutBufferSize);
                return STATUS_BUFFER_TOO_SMALL;
            }
            return HubWmiResetOverCurrent(Hub, (PUSB_CONNECTION_NOTIFICATION)Buffer);
 
        case AcquireBusInfo:
            return HubWmiBusInfo(Hub, OutBufferSize, (PUSB_BUS_NOTIFICATION)Buffer, BufferUsed);
 
        case AcquireHubName:
            return HubWmiHubNameRequest(Hub, OutBufferSize, (PUSB_ACQUIRE_INFO)Buffer, BufferUsed);
 
        case AcquireControllerName:
            return HubWmiControllerNameRequest(Hub, OutBufferSize, (PUSB_ACQUIRE_INFO)Buffer, BufferUsed);
 
        default:
            return STATUS_SUCCESS;
    }
}

Referenced by _IRQL_requires_().

HubWmiFirePortEvent()

static VOID NTAPI HubWmiFirePortEvent ( _In_ HubFdo *  Hub, _In_ ULONG  PortNumber, _In_ USB_NOTIFICATION_TYPE  Type  )

static

Definition at line 72 of file hubwmi.cpp.

{
    WDFWMIINSTANCE Instance = Hub->m_WmiInstance;
    USB_CONNECTION_NOTIFICATION Event;
    ULONG NameLength;
    NTSTATUS Status;
 
    /* A failed registration leaves no instance */
    if (Instance == NULL)
        return;
 
    if (!WdfWmiProviderIsEnabled(WdfWmiInstanceGetProvider(Instance), WdfWmiEventControl))
    {
        DPRINT("Hub %p: nobody listens for WMI event %d on port %lu\n", Hub, Type, PortNumber);
        return;
    }
 
    RtlZeroMemory(&Event, sizeof(Event));
    HubWmiHubName(Hub, &NameLength);
 
    Event.NotificationType = Type;
    Event.ConnectionNumber = PortNumber;
 
    /* What a USB_HUB_NAME query reports: the length field, the name and a NUL */
    Event.HubNameLength = NameLength + sizeof(ULONG) + sizeof(WCHAR);
 
    Status = WdfWmiInstanceFireEvent(Instance, sizeof(Event), &Event);
    if (!NT_SUCCESS(Status))
        DPRINT1("Hub %p: WMI event %d on port %lu failed 0x%lx\n", Hub, Type, PortNumber, Status);
}

Referenced by HubWmiNotifyOverCurrent().

HubWmiHubName()

static PCWSTR NTAPI HubWmiHubName ( _In_ HubFdo *  Hub, _Out_ PULONG  Length  )

static

Hub symbolic link without its "\??\" prefix. Bounded by the string length, not a NUL.

Definition at line 41 of file hubwmi.cpp.

{
    PCWSTR Text = Hub->m_SymbolicLinkName.Buffer;
    ULONG Count = Hub->m_SymbolicLinkName.Length / sizeof(WCHAR);
    ULONG Start = 0;
 
    *Length = 0;
    if (Text == NULL)
        return NULL;
 
    if (Count != 0 && Text[0] == L'\\')
    {
        for (Start = 1; Start < Count; Start++)
        {
            if (Text[Start] == L'\\' || Text[Start] == UNICODE_NULL)
                break;
        }
 
        if (Start < Count && Text[Start] == L'\\')
            Start++;
    }
 
    *Length = (Count - Start) * sizeof(WCHAR);
    return Text + Start;
}

Referenced by HubWmiFirePortEvent(), and HubWmiHubNameRequest().

HubWmiHubNameRequest()

static NTSTATUS NTAPI HubWmiHubNameRequest ( _In_ HubFdo *  Hub, _In_ ULONG  OutBufferSize, _Inout_ PUSB_ACQUIRE_INFO  Request, _Out_ PULONG  BufferUsed  )

static

A short TotalSize truncates the name without saying so.

Definition at line 509 of file hubwmi.cpp.

{
    PUCHAR Text = (PUCHAR)Request + FIELD_OFFSET(USB_ACQUIRE_INFO, Buffer);
    ULONG Room;
    ULONG NameLength;
    PCWSTR Name;
    ULONG Copy;
 
    if (!HubWmiAcquireSizeValid(Request, OutBufferSize))
        return STATUS_BUFFER_TOO_SMALL;
 
    Room = Request->TotalSize - FIELD_OFFSET(USB_ACQUIRE_INFO, Buffer);
    Name = HubWmiHubName(Hub, &NameLength);
    Copy = min(Room, NameLength);
 
    RtlZeroMemory(Text, Room);
    if (Copy != 0)
        RtlCopyMemory(Text, Name, Copy);
 
    *BufferUsed = FIELD_OFFSET(USB_ACQUIRE_INFO, Buffer) + Copy;
    return STATUS_SUCCESS;
}

Referenced by HubWmiExecuteMethod().

HubWmiNotifyOverCurrent()

VOID NTAPI HubWmiNotifyOverCurrent	(	_In_ HubFdo *	Hub,
		_In_ ULONG	PortNumber
	)

Definition at line 750 of file hubwmi.cpp.

{
    HubWmiFirePortEvent(Hub, PortNumber, OverCurrent);
}

Referenced by PortMachine::NotifyUserOfOverCurrent().

HubWmiQueryDeviceNode()

static NTSTATUS NTAPI HubWmiQueryDeviceNode ( _In_ WDFWMIINSTANCE  WmiInstance, _In_ ULONG  OutBufferSize, _Out_writes_bytes_to_(OutBufferSize, *BufferUsed) PVOID  OutBuffer, _Out_ PULONG  BufferUsed  )

static

Definition at line 323 of file hubwmi.cpp.

{
    WDFDEVICE Device = WdfWmiInstanceGetDevice(WmiInstance);
    HubPdo* Pdo = HubPdo::FromDevice(Device);
    PUSB_DEVICE_NODE_INFO Info = (PUSB_DEVICE_NODE_INFO)OutBuffer;
    HubChild* Child;
    HubFdo* Hub;
    UCHAR Depth;
    ULONG Length;
 
    *BufferUsed = sizeof(USB_DEVICE_NODE_INFO);
    if (OutBufferSize < sizeof(USB_DEVICE_NODE_INFO))
        return STATUS_BUFFER_TOO_SMALL;
 
    Child = Pdo->m_Child;
    if (Child == NULL)
    {
        DPRINT1("PDO %p WMI node query without a device\n", Pdo);
        *BufferUsed = 0;
        return STATUS_DEVICE_NOT_CONNECTED;
    }
 
    Hub = Child->m_Hub;
    RtlZeroMemory(OutBuffer, OutBufferSize);
 
    {
        HubSpinLockGuard Guard(&Child->m_ConfigLock);
        HubConfiguration* Config = Child->m_CurrentConfig;
 
        if (Child->HasState(ChildState::ConfigurationValid) && Config != NULL)
        {
            /* With no endpoints this is less than the unconfigured size */
            Length = FIELD_OFFSET(USB_DEVICE_NODE_INFO, UsbDeviceInfo.PipeList) +
                     Config->EndpointCount * sizeof(USB_PIPE_INFO);
            *BufferUsed = Length;
            if (Length > OutBufferSize)
                return STATUS_BUFFER_TOO_SMALL;
 
            Info->UsbDeviceInfo.CurrentConfigurationValue = Config->Descriptor.bConfigurationValue;
            Info->UsbDeviceInfo.NumberOfOpenPipes = Config->EndpointCount;
            HubWmiCopyPipes(Config, (PUSB_PIPE_INFO)HUB_WMI_FIELD(Info, UsbDeviceInfo.PipeList));
        }
    }
 
    Info->Sig = USB_NODE_INFO_SIG;
    Info->LengthInBytes = *BufferUsed;
    Info->NodeType = UsbDevice;
 
    Info->UsbDeviceInfo.DeviceDescriptor = Child->m_DeviceDescriptor;
    Info->UsbDeviceInfo.Speed = Child->Speed();
    Info->UsbDeviceInfo.PortNumber = Pdo->m_PortNumber;
    Info->UsbDeviceInfo.ConnectionIndex = Pdo->m_PortNumber;
    Info->UsbDeviceInfo.ConnectionStatus = Child->m_Port->m_ConnectionStatus;
 
    /* The device sits one tier below its hub */
    Info->BusAddress = Hub->m_Parent.HubTopologyAddress;
    Depth = Hub->m_Parent.HubDepth;
    if (Depth == 0)
        Info->BusAddress.RootHubPortNumber = Pdo->m_PortNumber;
    else if (Depth <= RTL_NUMBER_OF(Info->BusAddress.HubPortNumber))
        Info->BusAddress.HubPortNumber[Depth - 1] = Pdo->m_PortNumber;
 
    /* Truncated strings keep no NUL */
    HubWmiCopyProperty(Device,
                       DevicePropertyDeviceDescription,
                       HUB_WMI_FIELD(Info, DeviceDescription),
                       sizeof(Info->DeviceDescription));
    HubWmiCopyProperty(Device,
                       DevicePropertyHardwareID,
                       HUB_WMI_FIELD(Info, UsbDeviceInfo.PnpHardwareId),
                       sizeof(Info->UsbDeviceInfo.PnpHardwareId));
    HubWmiCopyProperty(Device,
                       DevicePropertyCompatibleIDs,
                       HUB_WMI_FIELD(Info, UsbDeviceInfo.PnpCompatibleId),
                       sizeof(Info->UsbDeviceInfo.PnpCompatibleId));
 
    if (Child->m_SerialNumber != NULL)
    {
        RtlCopyMemory(HUB_WMI_FIELD(Info, UsbDeviceInfo.SerialNumberId),
                      Child->m_SerialNumber,
                      min(Child->m_SerialNumberLength, sizeof(Info->UsbDeviceInfo.SerialNumberId)));
    }
 
    if (Child->m_FriendlyName != NULL)
    {
        RtlCopyMemory(HUB_WMI_FIELD(Info, UsbDeviceInfo.PnpDeviceDescription),
                      Child->m_FriendlyName,
                      min((ULONG)Child->m_FriendlyNameLength, sizeof(Info->UsbDeviceInfo.PnpDeviceDescription)));
    }
 
    return STATUS_SUCCESS;
}

HubWmiQueryHubNode()

static NTSTATUS NTAPI HubWmiQueryHubNode ( _In_ WDFWMIINSTANCE  WmiInstance, _In_ ULONG  OutBufferSize, _Out_writes_bytes_to_(OutBufferSize, *BufferUsed) PVOID  OutBuffer, _Out_ PULONG  BufferUsed  )

static

Definition at line 212 of file hubwmi.cpp.

{
    HubFdo* Hub = HubFdo::FromDevice(WdfWmiInstanceGetDevice(WmiInstance));
    PUSB_DEVICE_NODE_INFO Info = (PUSB_DEVICE_NODE_INFO)OutBuffer;
    PUSB_HUB_PORT_INFORMATION Entry;
    USB_HUB_DESCRIPTOR Descriptor;
    USHORT PortCount = (USHORT)Hub->m_PortCount;
    USHORT Index;
    USHORT Address;
    HubPort* Port;
    ULONG Needed;
 
    /* Sized as one full device block plus the extra ports, larger than the data */
    Needed = sizeof(USB_DEVICE_NODE_INFO) + ((ULONG)PortCount - 1) * sizeof(USB_HUB_PORT_INFORMATION);
    *BufferUsed = Needed;
    if (OutBufferSize < Needed)
    {
        DPRINT("Hub %p WMI node query needs %lu bytes, got %lu\n", Hub, Needed, OutBufferSize);
        return STATUS_BUFFER_TOO_SMALL;
    }
 
    RtlZeroMemory(OutBuffer, OutBufferSize);
 
    Info->Sig = USB_NODE_INFO_SIG;
    Info->LengthInBytes = Needed;
    Info->NodeType = HubDevice;
    Info->BusAddress = Hub->m_Parent.HubTopologyAddress;
 
    HubMakeUsb2StyleDescriptor(Hub, &Descriptor);
    Info->HubDeviceInfo.HubDescriptor = Descriptor;
    Info->HubDeviceInfo.HubNumber = Hub->m_HubNumber;
    Info->HubDeviceInfo.HubIsSelfPowered = (Hub->m_MaxPortPower != 100);
    Info->HubDeviceInfo.HubIsRootHub = Hub->IsRootHub();
    Info->HubDeviceInfo.NumberOfHubPorts = PortCount;
 
    /* Entries are numbered from 0 while ports start at 1: entry 0 stays empty and the last port is left out */
    Entry = (PUSB_HUB_PORT_INFORMATION)HUB_WMI_FIELD(Info, HubDeviceInfo.PortInfo);
    for (Index = 0; Index < PortCount; Index++, Entry++)
    {
        Entry->PortNumber = Index;
        Entry->ConnectionIndex = Index;
 
        Port = Hub->FindPort(Index);
        if (Port == NULL)
            continue;
 
        Entry->ConnectionStatus = HubWmiPortEntry(Hub, Port, Index, &Address);
        Entry->DeviceAddress = Address;
    }
 
    return STATUS_SUCCESS;
}

Referenced by _IRQL_requires_().

HubWmiResetOverCurrent()

static NTSTATUS NTAPI HubWmiResetOverCurrent ( _In_ HubFdo *  Hub, _In_ PUSB_CONNECTION_NOTIFICATION  Request  )

static

Accepts a reset only while the port machine waits for one after the over current popup.

Definition at line 426 of file hubwmi.cpp.

{
    HubPort* Port = Hub->FindPort(Request->ConnectionNumber);
    LONG Previous;
 
    if (Port == NULL)
    {
        DPRINT1("Hub %p over current reset for invalid port %lu\n", Hub, Request->ConnectionNumber);
        return STATUS_INVALID_PARAMETER;
    }
 
    Previous = InterlockedAnd(&Port->m_Flags, ~(LONG)PortFlag::OverCurrentResetArmed);
    if (Previous & (LONG)PortFlag::OverCurrentResetArmed)
    {
        DPRINT("Hub %p port %u over current reset requested by the user\n", Hub, Port->Number());
        Port->Post(PortEvent::UserOverCurrentReset);
    }
 
    return STATUS_SUCCESS;
}

Referenced by HubWmiExecuteMethod().

if() [1/4]

if

(

!

HubWmiAcquireSizeValidRequest, OutBufferSize

)

if() [2/4]

if

(

!

NT_SUCCESSStatus

)

Definition at line 473 of file hubwmi.cpp.

    {
        DPRINT1("Hub %p: controller name for WMI bus info failed 0x%lx\n", Hub, Status);
        return Status;
    }

if() [3/4]

if

(

!

NT_SUCCESSWdfDeviceAllocAndQueryProperty(Device, Property, NonPagedPool, &Attributes, &Memory)

)

if() [4/4]

if

(

)

Definition at line 463 of file hubwmi.cpp.

    {
        DPRINT1("Hub %p WMI bus info buffer of %lu bytes too small\n", Hub, OutBufferSize);
        return STATUS_BUFFER_TOO_SMALL;
    }

RtlCopyMemory()

RtlCopyMemory	(	Destination	,
		Data	,
		min(Length,(size_t) Size)
	)

WdfFdoLockStaticChildListForIteration()

WdfFdoLockStaticChildListForIteration

(

Hub->

m_Device

)

Referenced by HubIoLockChild().

WdfFdoUnlockStaticChildListFromIteration()

WdfFdoUnlockStaticChildListFromIteration

(

Hub->

m_Device

)

Referenced by HubIoUnlockChildren().

WdfObjectDelete()

WdfObjectDelete

(

Memory

)

WdfWmiInstanceCreate()

return WdfWmiInstanceCreate	(	Device	,
		&	Config,
		Attributes	,
		Instance
	)

Referenced by UcxController::RegisterWmi().

while()

while

(

(Child=WdfFdoRetrieveNextStaticChild(Hub->m_Device, Child, WdfRetrievePresentChildren)) !

= NULL

)

Definition at line 193 of file hubwmi.cpp.

    {
        Pdo = HubPdo::FromDevice(Child);
        if (Pdo->m_PortNumber != PortNumber)
            continue;
 
        if (Pdo->m_Child != NULL)
            *DeviceAddress = Pdo->m_Child->m_Address;
        break;
    }

Variable Documentation

ActualLength

Name ActualLength = 0

Definition at line 469 of file hubwmi.cpp.

Attributes

WDF_OBJECT_ATTRIBUTES_INIT& Attributes

Definition at line 116 of file hubwmi.cpp.

BufferUsed

* BufferUsed

Initial value:

{
    USB_HUB_NAME Name

Definition at line 458 of file hubwmi.cpp.

Referenced by HubWmiQueryDeviceNode().

Config

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG& Config

Definition at line 120 of file hubwmi.cpp.

ConsumedBandwidth

Notification ConsumedBandwidth = 0

Definition at line 480 of file hubwmi.cpp.

ControllerNameLength

Notification ControllerNameLength = Name.ActualLength

Definition at line 481 of file hubwmi.cpp.

Data

Data = WdfMemoryGetBuffer(Memory, &Length)

Definition at line 285 of file hubwmi.cpp.

DeviceAddress

* DeviceAddress

Initial value:

{
    WDFDEVICE Child = NULL

Definition at line 184 of file hubwmi.cpp.

Referenced by HalpConfigureDebuggingDevice(), HalpReleasePciDeviceForDebugging(), InitFloppyDrive(), UhciControlTransfer(), UhciMapAsyncTransferToTDs(), USBPORT_FreeUsbAddress(), USBPORT_InitializeDevice(), and while().

EvtWmiInstanceExecuteMethod

Config EvtWmiInstanceExecuteMethod = Method

Definition at line 128 of file hubwmi.cpp.

EvtWmiInstanceQueryInstance

Config EvtWmiInstanceQueryInstance = Query

Definition at line 127 of file hubwmi.cpp.

Flags

Provider Flags = ProviderFlags

Definition at line 123 of file hubwmi.cpp.

Guid

_In_ const GUID* Guid

Definition at line 112 of file hubwmi.cpp.

HubName

Name HubName[0] = UNICODE_NULL

Definition at line 470 of file hubwmi.cpp.

Referenced by HubPdoGetHubName(), and USBHI_GetRootHubSymbolicName().

HubWmiSurpriseLock

KSPIN_LOCK HubWmiSurpriseLock

static

Definition at line 35 of file hubwmi.cpp.

Referenced by HubWmiEvtSurpriseRemovalCleanup().

HubWmiSurpriseRemovalGuid

const GUID HubWmiSurpriseRemovalGuid

static

Initial value:

=
    { 0x9bbbf831, 0xa2f2, 0x43b4, { 0x96, 0xd1, 0x86, 0x94, 0x4b, 0x59, 0x14, 0xb3 } }

Definition at line 14 of file hubwmi.cpp.

Instance

_In_ const GUID _In_ ULONG _In_opt_ PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE _In_opt_ PFN_WDF_WMI_INSTANCE_EXECUTE_METHOD _In_opt_ PWDF_OBJECT_ATTRIBUTES _Out_opt_ WDFWMIINSTANCE* Instance

Initial value:

{
    WDF_WMI_PROVIDER_CONFIG Provider

Definition at line 117 of file hubwmi.cpp.

Referenced by _IRQL_requires_().

Length

size_t Length

Definition at line 284 of file hubwmi.cpp.

Referenced by HubWmiQueryDeviceNode().

m_ConnectionStatus

return Port m_ConnectionStatus

Definition at line 206 of file hubwmi.cpp.

Memory

WDFMEMORY Memory

Definition at line 283 of file hubwmi.cpp.

Method

_In_ const GUID _In_ ULONG _In_opt_ PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE _In_opt_ PFN_WDF_WMI_INSTANCE_EXECUTE_METHOD Method

Definition at line 115 of file hubwmi.cpp.

Referenced by CBDADeviceControl::CheckChanges(), CBDADeviceControl::CommitChanges(), CBDADeviceControl::CreateTopology(), D3DXCreateMeshFVFTest(), D3DXCreateMeshTest(), DECLARE_INTERFACE_(), FindMethodHandler(), IKsControl_fnKsMethod(), KsFastMethodHandler(), CInputPin::KsMethod(), CKsNode::KsMethod(), COutputPin::KsMethod(), CKsProxy::KsMethod(), KspMethodHandlerWithAllocator(), MainDialogProc(), PciIsSlotPresentInParentMethod(), RxLowIoPopulateFsctlInfo(), CBDADeviceControl::StartChanges(), and StartDefragThread().

Notification

_In_ ULONG _Inout_ PUSB_BUS_NOTIFICATION Notification

Definition at line 457 of file hubwmi.cpp.

OutBufferSize

_In_ ULONG OutBufferSize

Definition at line 456 of file hubwmi.cpp.

ParentObject

Attributes ParentObject = Device

Definition at line 288 of file hubwmi.cpp.

Pdo

HubPdo* Pdo

Definition at line 187 of file hubwmi.cpp.

Port

_In_ HubPort* Port

Definition at line 182 of file hubwmi.cpp.

Referenced by HubWmiQueryHubNode(), and HubWmiResetOverCurrent().

PortNumber

_In_ ULONG PortNumber

Initial value:

{
    HubWmiFirePortEvent(Hub, PortNumber, EnumerationFailure)

Definition at line 183 of file hubwmi.cpp.

Referenced by HubWmiFirePortEvent().

Property

_In_ DEVICE_REGISTRY_PROPERTY Property

Definition at line 278 of file hubwmi.cpp.

Provider

static struct Provider Provider

Initial value:

=
{
    { &ProviderSimpleVtbl },
    { &ProviderFragmentVtbl },
    { &ProviderFragmentRootVtbl },
    { &ProviderHwndOverrideVtbl },
    { &ProviderAdviseEventsVtbl },
    { &ProviderWinEventHandlerVtbl },
    { &ProviderValuePatternVtbl },
    { &ProviderLegacyIAccessiblePatternVtbl },
    1,
    "Provider",
    NULL, NULL,
    NULL, NULL,
    &Provider_child.IRawElementProviderFragment_iface, &Provider_child2.IRawElementProviderFragment_iface,
    0, 0, 0,
}

Definition at line 122 of file hubwmi.cpp.

ProviderFlags

_In_ const GUID _In_ ULONG ProviderFlags

Definition at line 113 of file hubwmi.cpp.

Query

_In_ const GUID _In_ ULONG _In_opt_ PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE Query

Definition at line 114 of file hubwmi.cpp.

Referenced by BasepGetComputerNameFromNtPath(), BrFolder_GetItemAttributes(), EvtSubscribe(), FdoDeviceControlQueryProperty(), CDefView::GetItemAttributes(), CDefView::GetSelectionAttributes(), HubPdoQueryCapability(), IopQueryBusDescription(), IopQueryDeviceDescription(), IoQueryDeviceDescription(), NtQueryInformationProcess(), NtQuerySystemInformation(), PdoDeviceControlQueryProperty(), PrintDiskData(), XhciController::QueryErrataDatabase(), QueryOperatingSystemInfo(), QueryProcessorInfo(), ScControl(), SH32_QueryAssocElementString(), SHELL_IncludeItemInFolderEnum(), StorPortInitializePerfOpts(), Test_ApphelpCheckRunApp(), UcxEvtDefaultIoInternalDeviceControl(), UcxQueryUsbCapability(), WSALookupServiceBeginW(), WSALookupServiceEnd(), WSALookupServiceNextW(), WsNqAddProvider(), WsNqDereference(), WsNqInitialize(), WsNqNextProvider(), WsNqPreviousProvider(), and WsNqValidateAndReference().

Register

Config Register = TRUE

Definition at line 126 of file hubwmi.cpp.

Referenced by __writemsr(), _Requires_lock_held_(), AHCI_HBA_READ(), AHCI_HBA_WRITE(), AHCI_PORT_READ(), AHCI_PORT_WRITE(), ApicInitializeIOApic(), ApicRead(), ApicWrite(), ApicWriteIORedirectionEntry(), AtaAhciPmpRead(), AtaAhciPmpWrite(), AtaAhciPollRegister(), AtaPdoWmiRegistration(), CmdCheckInterruptPci(), CmdSetTransferMode(), co_IntRegisterLogonProcess(), DC_READ(), DcWriteGpio(), DECLARE_INTERFACE_(), HalpConfigureDebuggingDevice(), HalpReadNvram(), HptHasUdmaCable(), HubMailboxTransfer(), IOApicRead(), IOApicWrite(), LpcReadRegister(), LpcWriteRegister(), XhciRegisters::ModifyCapability32(), NV_READ(), NV_WRITE(), PciEcamTransfer(), PhyInitRealtek8211b(), CMMCModule::PreMessageLoop(), HubMachine::ReadDromRegister(), FxDevice::ReadRegister(), FxDevice::ReadRegisterBuffer(), reg_unreg_wine_test_class(), FxDeviceInterface::Register(), UcxUsbDevice::RegisterComposite(), RegisterVDD(), ScsiPortReadRegisterBufferUchar(), ScsiPortReadRegisterBufferUlong(), ScsiPortReadRegisterBufferUshort(), ScsiPortReadRegisterUchar(), ScsiPortReadRegisterUlong(), ScsiPortReadRegisterUshort(), ScsiPortWriteRegisterBufferUchar(), ScsiPortWriteRegisterBufferUlong(), ScsiPortWriteRegisterBufferUshort(), ScsiPortWriteRegisterUchar(), ScsiPortWriteRegisterUlong(), ScsiPortWriteRegisterUshort(), SMBusWriteByte(), StorPortReadRegisterBufferUchar(), StorPortReadRegisterBufferUlong(), StorPortReadRegisterBufferUshort(), StorPortReadRegisterUchar(), StorPortReadRegisterUlong(), StorPortReadRegisterUshort(), StorPortWriteRegisterBufferUchar(), StorPortWriteRegisterBufferUlong(), StorPortWriteRegisterBufferUshort(), StorPortWriteRegisterUchar(), StorPortWriteRegisterUlong(), StorPortWriteRegisterUshort(), SvwSataScrRead(), SvwSataScrWrite(), test_wm_notify(), UpdateRegistryFromResource(), ViaScrReadIoPort(), ViaScrReadPci(), ViaScrWriteIoPort(), ViaScrWritePci(), HubMachine::WriteDromRegister(), FxDevice::WriteRegister(), FxDevice::WriteRegisterBuffer(), X2ApicMsrFromRegister(), X2ApicRead(), and X2ApicWrite().

Request

_In_ ULONG _Inout_ PUSB_ACQUIRE_INFO Request

Definition at line 544 of file hubwmi.cpp.

Size

_In_ DEVICE_REGISTRY_PROPERTY _In_ ULONG Size

Initial value:

{
    WDF_OBJECT_ATTRIBUTES Attributes

Definition at line 280 of file hubwmi.cpp.

Status

Status = HubQueryControllerName(Hub, &Name, sizeof(Name))

Definition at line 461 of file hubwmi.cpp.

Referenced by _IRQL_requires_(), HubWmiFirePortEvent(), and if().

STATUS_SUCCESS

return STATUS_SUCCESS

Definition at line 483 of file hubwmi.cpp.

Referenced by HubWmiExecuteMethod(), HubWmiHubNameRequest(), HubWmiQueryDeviceNode(), HubWmiQueryHubNode(), and HubWmiResetOverCurrent().

Total

Total = Request->TotalSize

Definition at line 548 of file hubwmi.cpp.

Referenced by append_multi_sz_value(), CheckMsOs20Registry(), CopyPacketToBufferChain(), Ext2BuildExtents(), DeviceMachine::ExtPropertiesValid(), FxCalculateObjectTotalSize(), FxCalculateObjectTotalSize2(), HubCustomPropertyValid(), HubIdListAppend(), InbvRotationThread(), NdisCopyFromPacketToPacket(), NdisCopyFromPacketToPacketSafe(), ObpIncrementHandleCount(), ObpIncrementUnnamedHandleCount(), PagePrompt(), PerfDataGetCommitChargeTotalK(), PerfDataGetKernelMemoryTotalK(), PerfDataGetPhysicalMemoryTotalK(), DeviceMachine::PrepareConfigLists(), DeviceMachine::PrepareInterfaceLists(), DeviceMachine::ReadBos(), DeviceMachine::ReadFullConfigDescriptor(), XhciIsochRing::SizeStage(), and Test_GetAvailableVidMem().

TotalBandwidth

Notification TotalBandwidth = 0

Definition at line 479 of file hubwmi.cpp.

TotalSize

Request TotalSize = Total - sizeof(ULONG)

Definition at line 555 of file hubwmi.cpp.

Referenced by AcpiRsGetAmlLength(), AtaFdoHandleGetScsiInquiryData(), AVrfpDebugPageHeapCreate(), BaseQuerySystemFirmware(), CallNt(), CmpSplitLeaf(), CKsAllocator::Commit(), CsrAllocateProcess(), DosCopyEnvironmentBlock(), DosLoadExecutableInternal(), ExpQuerySystemProcessInformation(), GetTListInfo(), CCabinet::InitCabinetHeader(), IoCreateDevice(), IopQueueDeviceChangeEvent(), IopQueueDeviceInstallEvent(), IopQueueDevicePropertyChangeEvent(), IopQueueTargetDeviceEvent(), KdpCopyMemoryChunks(), KsiCreateObjectType(), KspPropertyHandler(), MempAllocatePageTables(), MiDoMappedCopy(), MiDoPoolCopy(), QueryPointsFromMemory(), RtlCopyMemoryStreamTo(), RtlCreateHeap(), RtlpPageHeapCreate(), SaBlob_CreateHostent(), SepCreateToken(), SepDuplicateToken(), SepPerformTokenFiltering(), USBCCGP_BuildConfigurationDescriptor(), UsbdexBuildSelectConfigUrb(), UsbdexBuildSelectInterfaceUrb(), and WinLdrLoadNLSData().