hub.cpp

Go to the documentation of this file.

/*
 * PROJECT:     ReactOS SuperSpeed USB Hub Driver
 * LICENSE:     MIT (https://spdx.org/licenses/MIT)
 * PURPOSE:     Hub FDO creation and PnP power callbacks
 * COPYRIGHT:   Copyright 2026 Justin Miller <justinmiller100@gmail.com>
 */
 
#include "usbhub3.h"
 
#define NDEBUG
#include <debug.h>
 
NTSTATUS
NTAPI
HubEvtDeviceAdd(
    _In_ WDFDRIVER Driver,
    _Inout_ PWDFDEVICE_INIT DeviceInit)
{
    WDF_PNPPOWER_EVENT_CALLBACKS PnpPower;
    WDF_OBJECT_ATTRIBUTES Attributes;
    PHUB_FDO_CONTEXT Hub;
    WDFDEVICE Device;
    NTSTATUS Status;
 
    UNREFERENCED_PARAMETER(Driver);
    PAGED_CODE();
 
    WdfDeviceInitSetDeviceType(DeviceInit, FILE_DEVICE_USB);
 
    WDF_PNPPOWER_EVENT_CALLBACKS_INIT(&PnpPower);
    PnpPower.EvtDevicePrepareHardware = HubEvtDevicePrepareHardware;
    PnpPower.EvtDeviceReleaseHardware = HubEvtDeviceReleaseHardware;
    PnpPower.EvtDeviceD0Entry = HubEvtDeviceD0Entry;
    PnpPower.EvtDeviceD0Exit = HubEvtDeviceD0Exit;
    WdfDeviceInitSetPnpPowerEventCallbacks(DeviceInit, &PnpPower);
 
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&Attributes, HUB_FDO_CONTEXT);
 
    Status = WdfDeviceCreate(&DeviceInit, &Attributes, &Device);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("WdfDeviceCreate failed 0x%lx\n", Status);
        return Status;
    }
 
    Hub = HubGetFdoContext(Device);
    Hub->Device = Device;
    Hub->ParentTarget = WdfDeviceGetIoTarget(Device);
 
    return STATUS_SUCCESS;
}
 
NTSTATUS
NTAPI
HubEvtDevicePrepareHardware(
    _In_ WDFDEVICE Device,
    _In_ WDFCMRESLIST ResourcesRaw,
    _In_ WDFCMRESLIST ResourcesTranslated)
{
    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(ResourcesRaw);
    UNREFERENCED_PARAMETER(ResourcesTranslated);
 
    /* Query the controller stack interface from the parent, read the hub descriptor */
    UNIMPLEMENTED;
    return STATUS_SUCCESS;
}
 
NTSTATUS
NTAPI
HubEvtDeviceReleaseHardware(
    _In_ WDFDEVICE Device,
    _In_ WDFCMRESLIST ResourcesTranslated)
{
    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(ResourcesTranslated);
 
    UNIMPLEMENTED;
    return STATUS_SUCCESS;
}
 
NTSTATUS
NTAPI
HubEvtDeviceD0Entry(
    _In_ WDFDEVICE Device,
    _In_ WDF_POWER_DEVICE_STATE PreviousState)
{
    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(PreviousState);
 
    /* Power the ports and arm the status change interrupt transfer */
    UNIMPLEMENTED;
    return STATUS_SUCCESS;
}
 
NTSTATUS
NTAPI
HubEvtDeviceD0Exit(
    _In_ WDFDEVICE Device,
    _In_ WDF_POWER_DEVICE_STATE TargetState)
{
    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(TargetState);
 
    UNIMPLEMENTED;
    return STATUS_SUCCESS;
}