[bus] Remove unused member ext

[bus] Rename device member to Dev

[bus] Rename bus__start_thread to WvBusStartThread

[bus] Rename bus__process_work_items to WvBusProcessWorkItems

[bus] Rename bus__get to WvBusFromDev

[bus] Rename bus__add_child to WvBusAddChild

[bus] Rename bus__create to WvBusCreate

[bus] Rename bus__init to WvBusInit

[bus] Remove unused module init/shutdown declarations

They should have been removed in a previous commit.

[bus] Rename bus__get_dev_capabilities to WvBusGetDevCapabilities

[bus] Rename bus__thread_func to WV_F_BUS_THREAD

Using the naming convention briefly detailed in
commit 6a99f82ba3.

[bus] Rename bus__type to WV_S_BUS_T

Using the naming convention briefly detailed in
commit 6a99f82ba3.

[bus] Cosmetic change for header inclusion macro

[device,bus] Fix sizeof use in initialization

Oops!

[bus] Introduce PDO node addition/removal functions

WV_S_BUS_NODE is an opaque type representing a child
PDO node on a bus.

WvBusInitNode() will initialize such a node and associate
it with the DEVICE_OBJECT that is its physical device
object.

WvBusAddNode() will schedule the addition of a node to a
bus.  When bus__process_work_items() is called for the
bus, the addition will take place.

WvBusRemoveNode() will schedule the removal of a node
from a bus.  When bus__process_work_items() is called
for the bus, the removal will take place.

bus__process_work_items() should be called by the bus'
thread routine, because it expects to have sole control
over the linked list of bus nodes (no race conditions,
please).

And of course, you might notice the i'th coding style
change.  This one is more of a "when in Rome..." change.

  WV_ttt_mmm_nnn

  WV  : "WinVBlock"
  ttt : type; can be a combination of
      E : enum
      S : struct
      U : union
      A : array
      F : function
      P : pointer
      I : integer
      M : #defined macro
  mmm : module
  nnn : type name

[bus] Add bus__init for initializing to defaults

Now you know why a previous commit renamed the older
bus__init() function. :)

[device] Add device__init for initializing to defaults

Now you know why a previous commit renamed the older
device__init() function. :)

[ramdisk] Rename ramdisk__init to ramdisk__module_init

[filedisk] Rename filedisk__init to filedisk__module_init

[disk] Rename disk__init to disk__module_init

[bus,device] Allow for threaded PDO creation on a bus

bus__add_child() will add a PDO creation request to the
work item queue for a threaded bus, then wait for it to
complete.  We do this so that the PDO is created in the
bus' thread context.  For example, if the AoE driver were
to request a PDO, we want that PDO created by the WinVBlock
driver (the main bus' thread should be that context).

We add a completion signal pointer to work items, initialize
the signal upon adding a work item to a bus' queue, and
signal completion when a work item has been completed.

[bus] Let a threaded bus free itself

Hook device__type::ops.free() so that when called, it
schedules a freeing action but doesn't actually free.

[bus,driver] Introduce bus threading

The driver now calls bus__start_thread() on the main bus.

One can implement their own bus__thread_func routine and
assign it to the bus::thread member.  If one does so, one
should call bus__process_work_items() within the thread's
loop, and one should be responsible for freeing their bus.

[bus] Introduce work item queue and processing

bus__add_work_item_() will add a work item.

bus__get_work_item_() will get and dequeue a work item.

bus__process_work_items() will walk the work item queue
and process each work item.

[bus/pnp,disk/pnp,aoe] Get AoE sub-bus to work

Added some debugging messages to bus/pnp.c and disk/pnp.c.

Added a few PnP routines to bus/pnp.c.

Fixed a bug in aoe/bus.c where a hardware ID string was not
properly terminated.

Changed the IDs reported in aoe/bus.c.

A little note: The main WinVBlock bus might be better off
creating/deleting PDOs in its own thread context.

[irp,aoe] Remove mini IRP handling scheme

Goodbye, mini IRP handling scheme.

Since AoE still had remnants but doesn't yet work as a
sub-bus anyway, some fair changes were made to the AoE
module, such as renaming functions and changing the
IRP_MJ_DEVICE_CONTROL; aoe_bus__dev_ctl_dispatch_().

[project] Don't use mini IRP handling for IRP_MJ_PNP

Use device::irp_mj.pnp(), instead.

This is the last of the IRP_MJ_* major functions that were
previously handled with the mini IRP handling scheme.

[driver,device] Remove driver__default_dispatch function

driver__dispatch_() will handle the STATUS_NOT_SUPPORTED case.

[project] Don't use mini IRP handling for IRP_MJ_SCSI

Use device::irp_mj.scsi(), instead.

[project] Don't use mini IRP handling for IRP_MJ_DEVICE_CONTROL

Use device::irp_mj.dev_ctl(), instead.

[project] Don't use mini IRP handling for IRP_MJ_SYSTEM_CONTROL

Use device::irp_mj.sys_ctl(), instead.

[project] Don't use mini IRP handling for IRP_MJ_CREATE/CLOSE

There weren't really special implementations for bus and disk.

[project] Don't use mini IRP handling for IRP_MJ_POWER

Instead of using the mini IRP handling logic, we will
handle IRP_MJ_POWER differently.  This might be a trend...

Also introduced are:

driver__complete_irp() for common IRP completion logic.

device__dispatch_func typedef for IRP dispatch routines.

device::irp_mj is an pointer to an IRP handling table based
on major function code.

[bus] Minor cosmetic changes

[bus/pnp] Rename Bus_IoCompletionRoutine to bus_pnp__io_completion_

[bus] Rename power function to bus__power_

[aoe] Introduce AoE bus module

Currently not functional.  It seems that we need a major
IRP handling revisit. *sigh*

[bus] Handle PnP ID queries

[disk,device] Move disk__type::DiskNumber to device__type::dev_num

We can number all devices on a bus, rather than just disks.

[bus/dev_ctl] Minor cosmetic changes

[aoe] Even more cosmetic changes

And that won't be the end of it.

[bus] Rename bus__type::first_child_ptr to first_child

[aoe] More cosmetic changes

[disk,device] Move PnP ID query handling into device module

We should really allow for PnP ID query handling beyond just
for disks, so we now handle such queries as a device operation.

[device] Rename make_dev_pdo to device__make_pdo_

[device] Rename free_dev to device__free_dev_

[device] Remove device__init module startup function

There's not really a need to track all devices in a linked
list.  So now the module is purely library.

[device] Minor cosmetic changes.

[device] Don't use device__close_decl macro

Use a typedef, instead.

[device] Don't use winvblock__def_struct for device__type

[device,driver,protocol] Remove portable.h #include from header

For consistency with many other headers.

[device] Don't use winvblock__def_enum for device__state

And rename its values.

[bus,driver] Move attach_fdo into driver module

attach_fdo is really a _driver_ thing, rather than a
_bus_ thing, so we move it into the driver module as
driver__attach_fdo_().

This allows us to remove bus module initialization,
meaning the bus module should be purely library now.

Our driver's AddDevice routine (driver__attach_fdo_) is
hard-coded to only attach a maximum of one FDO, which
will be the main WinVBlock bus.  This could change later.

[bus] Rename sys_ctl to bus__sys_ctl_

[bus] Make callers of bus__add_child responsible...

...for freeing their device if bus__add_child() fails.
This is better than bus__add_child() freeing it, for the sake
of consistency in the code.  I accidentally re-freed not
once, but twice, while trying some things out.

[wv_stdlib] Use appropriate pool tags

For AoE:
"WinAoE" with tag 'EoAW'.

For WinVBlock:
"WinVBlock" with tag 'klBV'.

[bus,bus/pnp,disk/pnp] Don't use LowerDeviceObject if NULL

A bus might not be an FDO on top of some other PDO, so we should
only call a bus' "LowerDeviceObject" if it exists.

[bus] Add do-nothing bus__init_ function

In order to have a sub-bus as a node on a bus, we need to
implement a device__type::init function, since bus__add_child()
will call it on a child device.

[device] Remove device__init_decl macro

Use device__init_func typedef, instead.

[driver,bus] Move the "boot bus" into the driver module

It's now called driver__bus_fdo_ and is accessible via
driver__bus().  This involved some code shuffling.

Additionally, bus__create_pdo_() has been modified to
actually produce a vanilla bus PDO without hard-coding
the "boot bus" logic into it.

We also adjust bus__module_init() to move the "boot bus"
code out.

This effort is towards modules/drivers creating their
own bus.

[device] Use typedef for device__create_pdo_func

Instead of the device__create_pdo_decl() macro and
device__create_pdo_routine function pointer typedef.

[driver] Rename driver_dispatch to driver__dispatch_

[driver] Rename driver_dispatch_not_supported to driver__dispatch_not_supported_

[driver] Rename os_load_opts to driver__os_load_opts_

[driver] Rename Driver_Globals_Started to driver__started_

[driver] Rename Driver_Globals_StateHandle to driver__state_handle_

[driver] Rename Driver_Unload to driver__unload_

[device] Correct the return type for device__set

[driver] Minor style/cosmetic changes

Undoing all of the hard work that indent.sh did. *sigh*

[bus] Track boot__module_up_ as TRUE a bit earlier

We obviously have to track 'bus__module_up_' as 'TRUE'
_before_ the call to bus__create().  Oops.

[bus] Require module initialization for bus__create

Just like the previous commit regarding bus__add_child().

[bus] Track if the bus module has been initialized

Since bus__add_child() is a library function, we don't really
want a caller using it unless the WinVBlock driver is
actually running.  We now track module initialization status.

[bus] Rename bus__finalize to bus__module_shutdown

[bus] Rename bus__init to bus__module_init

Because 'bus__init' seems more like something you'd
do to a particular bus instance.

[bus] Rename Bus_GetDeviceCapabilities to bus__get_dev_capabilities

[bus] Don't use winvblock__def_struct for bus__type

[bus] Rename create_pdo to bus__create_pdo_

[bus] Rename free_bus to bus__free_

[bus] Rename bus_list to bus__list_

[bus] Rename bus_list_lock to bus__list_lock_

[bus] Rename boot_bus_fdo to bus__boot_fdo_

[bus] Minor style/cosmetic changes

Undoing all of the hard work that indent.sh did. *sigh*

[device] Introduce device__set function

Use this new device__set() to set a 'device' pointer for
a 'DEVICE_OBJECT'.

[bus] Rename bus__get_ptr to bus__get

And use a function instead of a macro.

[device] Introduce device__get function

Use this new device__get() to get a 'device' pointer from
a 'PDEVICE_OBJECT' instead of the old casting.  We still
need to change the casting used when _setting_ it, though.

[aoe] Rename get_aoe_disk_ptr to aoe__get_

[aoe] Rename aoe_disk_list to aoe__disk_list_

[aoe] Rename aoe_disk_list_lock to aoe__disk_list_lock_

[aoe] Rename AoE_Globals_Started to aoe__started_

[aoe] Rename AoE_Globals_ThreadHandle to aoe__thread_handle_

[aoe] Rename AoE_Globals_OutstandingTags to aoe__outstanding_tags_

[aoe] Rename AoE_Globals_DiskSearchList to aoe__disk_search_list_

[aoe] Rename AoE_Globals_ProbeTag to aoe__probe_tag_

[aoe] Rename AoE_Globals_TagList to aoe__tag_list_

[aoe] Rename AoE_Globals_TagListLast to aoe__tag_list_last_

[aoe] Rename AoE_Globals_ThreadSignalEvent to aoe__thread_sig_evt_

[aoe] Rename AoE_Globals_SpinLock to aoe__spinlock_

[aoe] Rename AoE_Globals_Stop to aoe__stop_

[aoe] Rename AoE_Globals_TargetList to aoe__target_list_

[aoe] Rename AoE_Globals_TargetListSpinLock to aoe__target_list_spinlock_