usbstor.c File Reference

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

Include dependency graph for usbstor.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
NTSTATUS NTAPI	USBSTOR_AddDevice (IN PDRIVER_OBJECT DriverObject, IN PDEVICE_OBJECT PhysicalDeviceObject)
VOID NTAPI	USBSTOR_Unload (PDRIVER_OBJECT DriverObject)
NTSTATUS NTAPI	USBSTOR_DispatchClose (PDEVICE_OBJECT DeviceObject, PIRP Irp)
NTSTATUS NTAPI	USBSTOR_DispatchDeviceControl (PDEVICE_OBJECT DeviceObject, PIRP Irp)
NTSTATUS NTAPI	USBSTOR_DispatchScsi (PDEVICE_OBJECT DeviceObject, PIRP Irp)
NTSTATUS NTAPI	USBSTOR_DispatchReadWrite (PDEVICE_OBJECT DeviceObject, PIRP Irp)
NTSTATUS NTAPI	USBSTOR_DispatchPnp (PDEVICE_OBJECT DeviceObject, PIRP Irp)
NTSTATUS NTAPI	USBSTOR_DispatchPower (PDEVICE_OBJECT DeviceObject, PIRP Irp)
NTSTATUS NTAPI	DriverEntry (IN PDRIVER_OBJECT DriverObject, IN PUNICODE_STRING RegPath)

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 15 of file usbstor.c.

Function Documentation

DriverEntry()

NTSTATUS NTAPI DriverEntry	(	IN PDRIVER_OBJECT	DriverObject,
		IN PUNICODE_STRING	RegPath
	)

Definition at line 240 of file usbstor.c.

{
 
    DPRINT("********* USB Storage *********\n");
 
    //
    // driver unload routine
    //
    DriverObject->DriverUnload = USBSTOR_Unload;
 
    //
    // add device function
    //
    DriverObject->DriverExtension->AddDevice = USBSTOR_AddDevice;
 
    //
    // driver start i/o routine
    //
    DriverObject->DriverStartIo = USBSTOR_StartIo;
 
    //
    // create / close
    //
    DriverObject->MajorFunction[IRP_MJ_CREATE] = USBSTOR_DispatchClose;
    DriverObject->MajorFunction[IRP_MJ_CLOSE] = USBSTOR_DispatchClose;
 
    //
    // scsi pass through requests
    //
    DriverObject->MajorFunction[IRP_MJ_DEVICE_CONTROL] = USBSTOR_DispatchDeviceControl;
 
    //
    // irp dispatch read / write
    //
    DriverObject->MajorFunction[IRP_MJ_READ] = USBSTOR_DispatchReadWrite;
    DriverObject->MajorFunction[IRP_MJ_WRITE] = USBSTOR_DispatchReadWrite;
 
    //
    // scsi queue ioctl
    //
    DriverObject->MajorFunction[IRP_MJ_SCSI] = USBSTOR_DispatchScsi;
 
    //
    // pnp processing
    //
    DriverObject->MajorFunction[IRP_MJ_PNP] = USBSTOR_DispatchPnp;
 
    //
    // power processing
    //
    DriverObject->MajorFunction[IRP_MJ_POWER] = USBSTOR_DispatchPower;
 
    return STATUS_SUCCESS;
}

USBSTOR_AddDevice()

NTSTATUS NTAPI USBSTOR_AddDevice	(	IN PDRIVER_OBJECT	DriverObject,
		IN PDEVICE_OBJECT	PhysicalDeviceObject
	)

Definition at line 22 of file usbstor.c.

{
    NTSTATUS Status;
    PDEVICE_OBJECT DeviceObject;
    PFDO_DEVICE_EXTENSION DeviceExtension;
 
    //
    // lets create the device
    //
    Status = IoCreateDevice(DriverObject, sizeof(FDO_DEVICE_EXTENSION), 0, FILE_DEVICE_BUS_EXTENDER, FILE_AUTOGENERATED_DEVICE_NAME | FILE_DEVICE_SECURE_OPEN, FALSE, &DeviceObject);
 
    //
    // check for success
    //
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("USBSTOR_AddDevice: Failed to create FDO Status %x\n", Status);
        return Status;
    }
 
    //
    // get device extension
    //
    DeviceExtension = (PFDO_DEVICE_EXTENSION)DeviceObject->DeviceExtension;
    ASSERT(DeviceExtension);
 
    //
    // zero device extension
    //
    RtlZeroMemory(DeviceExtension, sizeof(FDO_DEVICE_EXTENSION));
 
    //
    // initialize device extension
    //
    DeviceExtension->Common.IsFDO = TRUE;
    DeviceExtension->FunctionalDeviceObject = DeviceObject;
    DeviceExtension->PhysicalDeviceObject = PhysicalDeviceObject;
    DeviceExtension->LowerDeviceObject = IoAttachDeviceToDeviceStack(DeviceObject, PhysicalDeviceObject);
 
    //
    // init timer
    //
    IoInitializeTimer(DeviceObject, USBSTOR_TimerRoutine, (PVOID)DeviceExtension);
 
    //
    // did attaching fail
    //
    if (!DeviceExtension->LowerDeviceObject)
    {
        //
        // device removed
        //
        IoDeleteDevice(DeviceObject);
 
        return STATUS_DEVICE_REMOVED;
    }
 
    //
    // set device flags
    //
    DeviceObject->Flags |= DO_BUFFERED_IO | DO_POWER_PAGABLE;
 
    //
    // device is initialized
    //
    DeviceObject->Flags &= ~DO_DEVICE_INITIALIZING;
 
 
    //
    // done
    //
    return STATUS_SUCCESS;
}

USBSTOR_DispatchClose()

NTSTATUS NTAPI USBSTOR_DispatchClose	(	PDEVICE_OBJECT	DeviceObject,
		PIRP	Irp
	)

Definition at line 110 of file usbstor.c.

{
    //
    // function always succeeds ;)
    //
    DPRINT("USBSTOR_DispatchClose\n");
    Irp->IoStatus.Information = 0;
    Irp->IoStatus.Status = STATUS_SUCCESS;
    IoCompleteRequest(Irp, IO_NO_INCREMENT);
    return STATUS_SUCCESS;
}

USBSTOR_DispatchDeviceControl()

NTSTATUS NTAPI USBSTOR_DispatchDeviceControl	(	PDEVICE_OBJECT	DeviceObject,
		PIRP	Irp
	)

Definition at line 127 of file usbstor.c.

{
    NTSTATUS Status;
 
    //
    // handle requests
    //
    Status = USBSTOR_HandleDeviceControl(DeviceObject, Irp);
 
    //
    // complete request
    //
    Irp->IoStatus.Status = Status;
    IoCompleteRequest(Irp, IO_NO_INCREMENT);
 
    //
    // done
    //
    return Status;
}

USBSTOR_DispatchPnp()

NTSTATUS NTAPI USBSTOR_DispatchPnp	(	PDEVICE_OBJECT	DeviceObject,
		PIRP	Irp
	)

Definition at line 180 of file usbstor.c.

{
    PUSBSTOR_COMMON_DEVICE_EXTENSION DeviceExtension;
 
    //
    // get common device extension
    //
    DeviceExtension = (PUSBSTOR_COMMON_DEVICE_EXTENSION)DeviceObject->DeviceExtension;
 
    //
    // is it for the FDO
    //
    if (DeviceExtension->IsFDO)
    {
        //
        // dispatch pnp request to fdo pnp handler
        //
        return USBSTOR_FdoHandlePnp(DeviceObject, Irp);
    }
    else
    {
        //
        // dispatch request to pdo pnp handler
        //
        return USBSTOR_PdoHandlePnp(DeviceObject, Irp);
    }
}

USBSTOR_DispatchPower()

NTSTATUS NTAPI USBSTOR_DispatchPower	(	PDEVICE_OBJECT	DeviceObject,
		PIRP	Irp
	)

Definition at line 212 of file usbstor.c.

{
    PFDO_DEVICE_EXTENSION DeviceExtension;
 
    // get common device extension
    DeviceExtension = (PFDO_DEVICE_EXTENSION)DeviceObject->DeviceExtension;
 
    if (DeviceExtension->Common.IsFDO)
    {
        PoStartNextPowerIrp(Irp);
        IoSkipCurrentIrpStackLocation(Irp);
        return PoCallDriver(DeviceExtension->LowerDeviceObject, Irp);
    }
    else
    {
        PoStartNextPowerIrp(Irp);
        Irp->IoStatus.Status = STATUS_SUCCESS;
        IoCompleteRequest(Irp, IO_NO_INCREMENT);
        return STATUS_SUCCESS;
    }
}

USBSTOR_DispatchReadWrite()

NTSTATUS NTAPI USBSTOR_DispatchReadWrite	(	PDEVICE_OBJECT	DeviceObject,
		PIRP	Irp
	)

Definition at line 165 of file usbstor.c.

{
    //
    // read write ioctl is not supported
    //
    Irp->IoStatus.Information = 0;
    Irp->IoStatus.Status = STATUS_INVALID_PARAMETER;
    IoCompleteRequest(Irp, IO_NO_INCREMENT);
    return STATUS_INVALID_PARAMETER;
}

USBSTOR_DispatchScsi()

NTSTATUS NTAPI USBSTOR_DispatchScsi	(	PDEVICE_OBJECT	DeviceObject,
		PIRP	Irp
	)

Definition at line 153 of file usbstor.c.

{
    //
    // handle requests
    //
    return USBSTOR_HandleInternalDeviceControl(DeviceObject, Irp);
}

USBSTOR_Unload()

VOID NTAPI USBSTOR_Unload

(

PDRIVER_OBJECT

DriverObject

)

Definition at line 100 of file usbstor.c.

{
    //
    // no-op
    //
}