ntoskrnl/include/internal/io.h

   1 /*
   2 * PROJECT:         ReactOS Kernel
   3 * LICENSE:         GPL - See COPYING in the top level directory
   4 * FILE:            ntoskrnl/include/io.h
   5 * PURPOSE:         Internal header for the I/O Manager
   6 * PROGRAMMERS:     Alex Ionescu (alex.ionescu@reactos.org)
   7 */
   8 #include "ntdddisk.h"
   9
  10 //
  11 // Define this if you want debugging support
  12 //
  13 #define _IO_DEBUG_                                      0x00
  14
  15 //
  16 // These define the Debug Masks Supported
  17 //
  18 #define IO_IRP_DEBUG                                    0x01
  19 #define IO_FILE_DEBUG                                   0x02
  20 #define IO_API_DEBUG                                    0x04
  21 #define IO_CTL_DEBUG                                    0x08
  22
  23 //
  24 // Debug/Tracing support
  25 //
  26 #if _IO_DEBUG_
  27 #ifdef NEW_DEBUG_SYSTEM_IMPLEMENTED // enable when Debug Filters are implemented
  28 #define IOTRACE(x, ...)                                     \
  29     {                                                       \
  30         DbgPrintEx("%s [%.16s] - ",                         \
  31                    __FUNCTION__,                            \
  32                    PsGetCurrentProcess()->ImageFileName);   \
  33         DbgPrintEx(__VA_ARGS__);                            \
  34     }
  35 #else
  36 #define IOTRACE(x, ...)                                     \
  37     if (x & IopTraceLevel)                                  \
  38     {                                                       \
  39         DbgPrint("%s [%.16s] - ",                           \
  40                  __FUNCTION__,                              \
  41                  PsGetCurrentProcess()->ImageFileName);     \
  42         DbgPrint(__VA_ARGS__);                              \
  43     }
  44 #endif
  45 #else
  46 #define IOTRACE(x, ...) DPRINT(__VA_ARGS__)
  47 #endif
  48
  49 //
  50 // Registry path to the enumeration root key
  51 //
  52 #define ENUM_ROOT L"\\Registry\\Machine\\System\\CurrentControlSet\\Enum"
  53
  54 //
  55 // Returns the type of METHOD_ used in this IOCTL
  56 //
  57 #define IO_METHOD_FROM_CTL_CODE(c)                      (c & 0x00000003)
  58
  59 //
  60 // Bugcheck codes for RAM disk booting
  61 //
  62 //
  63 // No LoaderXIPRom descriptor was found in the loader memory list
  64 //
  65 #define RD_NO_XIPROM_DESCRIPTOR  1
  66 //
  67 // Unable to open the RAM disk driver (ramdisk.sys or \Device\Ramdisk)
  68 //
  69 #define RD_NO_RAMDISK_DRIVER     2
  70 //
  71 // FSCTL_CREATE_RAM_DISK failed
  72 //
  73 #define RD_FSCTL_FAILED          3
  74 //
  75 // Unable to create GUID string from binary GUID
  76 //
  77 #define RD_GUID_CONVERT_FAILED   4
  78 //
  79 // Unable to create symbolic link pointing to the RAM disk device
  80 //
  81 #define RD_SYMLINK_CREATE_FAILED 5
  82
  83 //
  84 // We can call the Ob Inlined API, it's the same thing
  85 //
  86 #define IopAllocateMdlFromLookaside                     \
  87     ObpAllocateObjectCreateInfoBuffer
  88 #define IopFreeMdlFromLookaside                         \
  89     ObpFreeCapturedAttributes
  90
  91 //
  92 // Determines if the IRP is Synchronous
  93 //
  94 #define IsIrpSynchronous(Irp, FileObject)               \
  95     ((Irp->Flags & IRP_SYNCHRONOUS_API)  ||             \
  96      (!(FileObject) ?                                   \
  97         FALSE :                                         \
  98         FileObject->Flags & FO_SYNCHRONOUS_IO))         \
  99
 100 //
 101 // Returns the internal Device Object Extension
 102 //
 103 #define IoGetDevObjExtension(DeviceObject)              \
 104     ((PEXTENDED_DEVOBJ_EXTENSION)                       \
 105      (DeviceObject->DeviceObjectExtension))             \
 106
 107 //
 108 // Returns the internal Driver Object Extension
 109 //
 110 #define IoGetDrvObjExtension(DriverObject)              \
 111     ((PEXTENDED_DRIVER_EXTENSION)                       \
 112      (DriverObject->DriverExtension))                   \
 113
 114 /*
 115  * VOID
 116  * IopDeviceNodeSetFlag(
 117  *   PDEVICE_NODE DeviceNode,
 118  *   ULONG Flag);
 119  */
 120 #define IopDeviceNodeSetFlag(DeviceNode, Flag)          \
 121     ((DeviceNode)->Flags |= (Flag))
 122
 123 /*
 124  * VOID
 125  * IopDeviceNodeClearFlag(
 126  *   PDEVICE_NODE DeviceNode,
 127  *   ULONG Flag);
 128  */
 129 #define IopDeviceNodeClearFlag(DeviceNode, Flag)        \
 130     ((DeviceNode)->Flags &= ~(Flag))
 131
 132 /*
 133  * BOOLEAN
 134  * IopDeviceNodeHasFlag(
 135  *   PDEVICE_NODE DeviceNode,
 136  *   ULONG Flag);
 137  */
 138 #define IopDeviceNodeHasFlag(DeviceNode, Flag)          \
 139     (((DeviceNode)->Flags & (Flag)) > 0)
 140
 141 /*
 142  * VOID
 143  * IopDeviceNodeSetUserFlag(
 144  *   PDEVICE_NODE DeviceNode,
 145  *   ULONG UserFlag);
 146  */
 147 #define IopDeviceNodeSetUserFlag(DeviceNode, UserFlag)  \
 148     ((DeviceNode)->UserFlags |= (UserFlag))
 149
 150 /*
 151  * VOID
 152  * IopDeviceNodeClearUserFlag(
 153  *   PDEVICE_NODE DeviceNode,
 154  *   ULONG UserFlag);
 155  */
 156 #define IopDeviceNodeClearUserFlag(DeviceNode, UserFlag)\
 157     ((DeviceNode)->UserFlags &= ~(UserFlag))
 158
 159 /*
 160  * BOOLEAN
 161  * IopDeviceNodeHasUserFlag(
 162  *   PDEVICE_NODE DeviceNode,
 163  *   ULONG UserFlag);
 164  */
 165 #define IopDeviceNodeHasUserFlag(DeviceNode, UserFlag)  \
 166     (((DeviceNode)->UserFlags & (UserFlag)) > 0)
 167
 168  /*
 169  * VOID
 170  * IopDeviceNodeSetProblem(
 171  *   PDEVICE_NODE DeviceNode,
 172  *   ULONG Problem);
 173  */
 174 #define IopDeviceNodeSetProblem(DeviceNode, Problem)    \
 175     ((DeviceNode)->Problem |= (Problem))
 176
 177 /*
 178  * VOID
 179  * IopDeviceNodeClearProblem(
 180  *   PDEVICE_NODE DeviceNode,
 181  *   ULONG Problem);
 182  */
 183 #define IopDeviceNodeClearProblem(DeviceNode, Problem)  \
 184     ((DeviceNode)->Problem &= ~(Problem))
 185
 186 /*
 187  * BOOLEAN
 188  * IopDeviceNodeHasProblem(
 189  *   PDEVICE_NODE DeviceNode,
 190  *   ULONG Problem);
 191  */
 192 #define IopDeviceNodeHasProblem(DeviceNode, Problem)    \
 193     (((DeviceNode)->Problem & (Problem)) > 0)
 194
 195 /*
 196  * VOID
 197  * IopInitDeviceTreeTraverseContext(
 198  *   PDEVICETREE_TRAVERSE_CONTEXT DeviceTreeTraverseContext,
 199  *   PDEVICE_NODE DeviceNode,
 200  *   DEVICETREE_TRAVERSE_ROUTINE Action,
 201  *   PVOID Context);
 202  */
 203 #define IopInitDeviceTreeTraverseContext(               \
 204     _DeviceTreeTraverseContext, _DeviceNode, _Action,   \
 205     _Context) {                                         \
 206     (_DeviceTreeTraverseContext)->FirstDeviceNode =     \
 207         (_DeviceNode);                                  \
 208     (_DeviceTreeTraverseContext)->Action = (_Action);   \
 209     (_DeviceTreeTraverseContext)->Context = (_Context); }
 210
 211 //
 212 // Device List Operations
 213 //
 214 typedef enum _IOP_DEVICE_LIST_OPERATION
 215 {
 216     IopRemove,
 217     IopAdd
 218 } IOP_DEVICE_LIST_OPERATION, *PIOP_DEVICE_LIST_OPERATION;
 219
 220 //
 221 // Transfer statistics
 222 //
 223 typedef enum _IOP_TRANSFER_TYPE
 224 {
 225     IopReadTransfer,
 226     IopWriteTransfer,
 227     IopOtherTransfer
 228 } IOP_TRANSFER_TYPE, *PIOP_TRANSFER_TYPE;
 229
 230 //
 231 // Packet Types when piggybacking on the IRP Overlay
 232 //
 233 typedef enum _COMPLETION_PACKET_TYPE
 234     {
 235     IopCompletionPacketIrp,
 236     IopCompletionPacketMini,
 237     IopCompletionPacketQuota
 238 } COMPLETION_PACKET_TYPE, *PCOMPLETION_PACKET_TYPE;
 239
 240 //
 241 // Special version of the IRP Overlay used to optimize I/O completion
 242 // by not using up a separate structure.
 243 //
 244 typedef struct _IOP_MINI_COMPLETION_PACKET
 245 {
 246     struct
 247     {
 248         LIST_ENTRY ListEntry;
 249         union
 250         {
 251             struct _IO_STACK_LOCATION *CurrentStackLocation;
 252             ULONG PacketType;
 253         };
 254     };
 255     PVOID KeyContext;
 256     PVOID ApcContext;
 257     NTSTATUS IoStatus;
 258     ULONG_PTR IoStatusInformation;
 259 } IOP_MINI_COMPLETION_PACKET, *PIOP_MINI_COMPLETION_PACKET;
 260
 261 //
 262 // I/O Completion Context for IoSetIoCompletionRoutineEx
 263 //
 264 typedef struct _IO_UNLOAD_SAFE_COMPLETION_CONTEXT
 265 {
 266     PDEVICE_OBJECT DeviceObject;
 267     PVOID Context;
 268     PIO_COMPLETION_ROUTINE CompletionRoutine;
 269 } IO_UNLOAD_SAFE_COMPLETION_CONTEXT, *PIO_UNLOAD_SAFE_COMPLETION_CONTEXT;
 270
 271 //
 272 // I/O Wrapper around the Executive Work Item
 273 //
 274 typedef struct _IO_WORKITEM
 275 {
 276     WORK_QUEUE_ITEM Item;
 277     PDEVICE_OBJECT DeviceObject;
 278     PIO_WORKITEM_ROUTINE WorkerRoutine;
 279     PVOID Context;
 280 } IO_WORKITEM;
 281
 282 //
 283 // I/O Wrapper around the Kernel Interrupt
 284 //
 285 typedef struct _IO_INTERRUPT
 286 {
 287     KINTERRUPT FirstInterrupt;
 288     PKINTERRUPT Interrupt[MAXIMUM_PROCESSORS];
 289     KSPIN_LOCK SpinLock;
 290 } IO_INTERRUPT, *PIO_INTERRUPT;
 291
 292 //
 293 // I/O Error Log Packet Header
 294 //
 295 typedef struct _ERROR_LOG_ENTRY
 296 {
 297     CSHORT Type;
 298     CSHORT Size;
 299     LIST_ENTRY ListEntry;
 300     PDEVICE_OBJECT DeviceObject;
 301     PDRIVER_OBJECT DriverObject;
 302     LARGE_INTEGER TimeStamp;
 303 } ERROR_LOG_ENTRY, *PERROR_LOG_ENTRY;
 304
 305 //
 306 // Event Log LPC Message
 307 //
 308 typedef struct _ELF_API_MSG
 309 {
 310     PORT_MESSAGE h;
 311     ULONG Unknown[2];
 312     IO_ERROR_LOG_MESSAGE IoErrorMessage;
 313 } ELF_API_MSG, *PELF_API_MSG;
 314
 315 //
 316 // To simplify matters, the kernel is made to support both the checked and free
 317 // version of the I/O Remove Lock in the same binary. This structure includes
 318 // both, since the DDK has the structure with a compile-time #ifdef.
 319 //
 320 typedef struct _EXTENDED_IO_REMOVE_LOCK
 321 {
 322     IO_REMOVE_LOCK_COMMON_BLOCK Common;
 323     IO_REMOVE_LOCK_DBG_BLOCK Dbg;
 324 } EXTENDED_IO_REMOVE_LOCK, *PEXTENDED_IO_REMOVE_LOCK;
 325
 326 //
 327 // Dummy File Object used inside the Open Packet so that OB knows how to
 328 // deal with the Object Pointer even though it's not a real file.
 329 //
 330 typedef struct _DUMMY_FILE_OBJECT
 331 {
 332     OBJECT_HEADER ObjectHeader;
 333     CHAR FileObjectBody[sizeof(FILE_OBJECT)];
 334 } DUMMY_FILE_OBJECT, *PDUMMY_FILE_OBJECT;
 335
 336 //
 337 // Open packet used as a context for Device/File parsing so that the parse
 338 // routine can know what operation is being requested.
 339 //
 340 typedef struct _OPEN_PACKET
 341 {
 342     CSHORT Type;
 343     CSHORT Size;
 344     PFILE_OBJECT FileObject;
 345     NTSTATUS FinalStatus;
 346     ULONG_PTR Information;
 347     ULONG ParseCheck;
 348     PFILE_OBJECT RelatedFileObject;
 349     OBJECT_ATTRIBUTES OriginalAttributes;
 350     LARGE_INTEGER AllocationSize;
 351     ULONG CreateOptions;
 352     USHORT FileAttributes;
 353     USHORT ShareAccess;
 354     PVOID EaBuffer;
 355     ULONG EaLength;
 356     ULONG Options;
 357     ULONG Disposition;
 358     PFILE_BASIC_INFORMATION BasicInformation;
 359     PFILE_NETWORK_OPEN_INFORMATION NetworkInformation;
 360     CREATE_FILE_TYPE CreateFileType;
 361     PVOID MailslotOrPipeParameters;
 362     BOOLEAN Override;
 363     BOOLEAN QueryOnly;
 364     BOOLEAN DeleteOnly;
 365     BOOLEAN FullAttributes;
 366     PDUMMY_FILE_OBJECT DummyFileObject;
 367     ULONG InternalFlags;
 368     //PIO_DRIVER_CREATE_CONTEXT DriverCreateContext; Vista only, needs ROS DDK Update
 369 } OPEN_PACKET, *POPEN_PACKET;
 370
 371 //
 372 // Parameters packet for Load/Unload work item's context
 373 //
 374 typedef struct _LOAD_UNLOAD_PARAMS
 375 {
 376     NTSTATUS Status;
 377     PUNICODE_STRING ServiceName;
 378     WORK_QUEUE_ITEM WorkItem;
 379     KEVENT Event;
 380     PDRIVER_OBJECT DriverObject;
 381 } LOAD_UNLOAD_PARAMS, *PLOAD_UNLOAD_PARAMS;
 382
 383 //
 384 // Boot Driver List Entry
 385 //
 386 typedef struct _DRIVER_INFORMATION
 387 {
 388     LIST_ENTRY Link;
 389     PDRIVER_OBJECT DriverObject;
 390     PBOOT_DRIVER_LIST_ENTRY DataTableEntry;
 391     HANDLE ServiceHandle;
 392     USHORT TagPosition;
 393     ULONG Failed;
 394     ULONG Processed;
 395     NTSTATUS Status;
 396 } DRIVER_INFORMATION, *PDRIVER_INFORMATION;
 397
 398 //
 399 // Boot Driver Node
 400 //
 401 typedef struct _BOOT_DRIVER_NODE
 402 {
 403     BOOT_DRIVER_LIST_ENTRY ListEntry;
 404     UNICODE_STRING Group;
 405     UNICODE_STRING Name;
 406     ULONG Tag;
 407     ULONG ErrorControl;
 408 } BOOT_DRIVER_NODE, *PBOOT_DRIVER_NODE;
 409
 410 //
 411 // List of Bus Type GUIDs
 412 //
 413 typedef struct _IO_BUS_TYPE_GUID_LIST
 414 {
 415     ULONG GuidCount;
 416     FAST_MUTEX Lock;
 417     GUID Guids[1];
 418 } IO_BUS_TYPE_GUID_LIST, *PIO_BUS_TYPE_GUID_LIST;
 419 extern PIO_BUS_TYPE_GUID_LIST IopBusTypeGuidList;
 420
 421 //
 422 // Shutdown entry for registed devices
 423 //
 424 typedef struct _SHUTDOWN_ENTRY
 425 {
 426     LIST_ENTRY ShutdownList;
 427     PDEVICE_OBJECT DeviceObject;
 428 } SHUTDOWN_ENTRY, *PSHUTDOWN_ENTRY;
 429
 430 //
 431 // F/S Notification entry for registered File Systems
 432 //
 433 typedef struct _FS_CHANGE_NOTIFY_ENTRY
 434 {
 435     LIST_ENTRY FsChangeNotifyList;
 436     PDRIVER_OBJECT DriverObject;
 437     PDRIVER_FS_NOTIFICATION FSDNotificationProc;
 438 } FS_CHANGE_NOTIFY_ENTRY, *PFS_CHANGE_NOTIFY_ENTRY;
 439
 440 //
 441 // Driver (Boot) Re-Initialization Entry
 442 //
 443 typedef struct _DRIVER_REINIT_ITEM
 444 {
 445     LIST_ENTRY ItemEntry;
 446     PDRIVER_OBJECT DriverObject;
 447     PDRIVER_REINITIALIZE ReinitRoutine;
 448     PVOID Context;
 449 } DRIVER_REINIT_ITEM, *PDRIVER_REINIT_ITEM;
 450
 451 //
 452 // Called on every visit of a node during a preorder-traversal of the device
 453 // node tree.
 454 // If the routine returns STATUS_UNSUCCESSFUL the traversal will stop and
 455 // STATUS_SUCCESS is returned to the caller who initiated the tree traversal.
 456 // Any other returned status code will be returned to the caller. If a status
 457 // code that indicates an error (other than STATUS_UNSUCCESSFUL) is returned,
 458 // the traversal is stopped immediately and the status code is returned to
 459 // the caller.
 460 //
 461 typedef
 462 NTSTATUS
 463 (*DEVICETREE_TRAVERSE_ROUTINE)(
 464     IN PDEVICE_NODE DeviceNode,
 465     IN PVOID Context
 466 );
 467
 468 //
 469 // Context information for traversing the device tree
 470 //
 471 typedef struct _DEVICETREE_TRAVERSE_CONTEXT
 472 {
 473     //
 474     // Current device node during a traversal
 475     //
 476     PDEVICE_NODE DeviceNode;
 477
 478     //
 479     // Initial device node where we start the traversal
 480     //
 481     PDEVICE_NODE FirstDeviceNode;
 482
 483     //
 484     // Action routine to be called for every device node
 485     //
 486     DEVICETREE_TRAVERSE_ROUTINE Action;
 487
 488     //
 489     // Context passed to the action routine
 490     //
 491     PVOID Context;
 492 } DEVICETREE_TRAVERSE_CONTEXT, *PDEVICETREE_TRAVERSE_CONTEXT;
 493
 494 //
 495 // Resource code
 496 //
 497 ULONG
 498 NTAPI
 499 IopCalculateResourceListSize(
 500     IN PCM_RESOURCE_LIST ResourceList
 501 );
 502
 503 NTSTATUS
 504 NTAPI
 505 IopAssignDeviceResources(
 506     IN PDEVICE_NODE DeviceNode
 507 );
 508
 509 //
 510 // PNP Routines
 511 //
 512 NTSTATUS
 513 NTAPI
 514 PipCallDriverAddDevice(
 515     IN PDEVICE_NODE DeviceNode,
 516     IN BOOLEAN LoadDriver,
 517     IN PDRIVER_OBJECT DriverObject
 518 );
 519
 520 NTSTATUS
 521 NTAPI
 522 IopInitializePlugPlayServices(
 523     VOID
 524 );
 525
 526 BOOLEAN
 527 NTAPI
 528 PpInitSystem(
 529     VOID
 530 );
 531
 532 VOID
 533 PnpInit2(
 534     VOID
 535 );
 536
 537 VOID
 538 IopInitDriverImplementation(
 539     VOID
 540 );
 541
 542 VOID
 543 IopInitPnpNotificationImplementation(
 544     VOID
 545 );
 546
 547 VOID
 548 IopNotifyPlugPlayNotification(
 549     IN PDEVICE_OBJECT DeviceObject,
 550     IN IO_NOTIFICATION_EVENT_CATEGORY EventCategory,
 551     IN LPCGUID Event,
 552     IN PVOID EventCategoryData1,
 553     IN PVOID EventCategoryData2
 554 );
 555
 556 NTSTATUS
 557 IopGetSystemPowerDeviceObject(
 558     IN PDEVICE_OBJECT *DeviceObject
 559 );
 560
 561 PDEVICE_NODE
 562 NTAPI
 563 PipAllocateDeviceNode(
 564     IN PDEVICE_OBJECT PhysicalDeviceObject
 565 );
 566
 567 NTSTATUS
 568 IopCreateDeviceNode(
 569     IN PDEVICE_NODE ParentNode,
 570     IN PDEVICE_OBJECT PhysicalDeviceObject,
 571     IN PUNICODE_STRING ServiceName,
 572     OUT PDEVICE_NODE *DeviceNode
 573 );
 574
 575 NTSTATUS
 576 IopFreeDeviceNode(
 577     IN PDEVICE_NODE DeviceNode
 578 );
 579
 580 NTSTATUS
 581 NTAPI
 582 IopSynchronousCall(
 583     IN PDEVICE_OBJECT DeviceObject,
 584     IN PIO_STACK_LOCATION IoStackLocation,
 585     OUT PVOID *Information
 586 );
 587
 588 NTSTATUS
 589 NTAPI
 590 IopInitiatePnpIrp(
 591     IN PDEVICE_OBJECT DeviceObject,
 592     IN PIO_STATUS_BLOCK IoStatusBlock,
 593     IN ULONG MinorFunction,
 594     IN PIO_STACK_LOCATION Stack
 595 );
 596
 597 PDEVICE_NODE
 598 FASTCALL
 599 IopGetDeviceNode(
 600     IN PDEVICE_OBJECT DeviceObject
 601 );
 602
 603 NTSTATUS
 604 IopActionConfigureChildServices(
 605     IN PDEVICE_NODE DeviceNode,
 606     IN PVOID Context
 607 );
 608
 609 NTSTATUS
 610 IopActionInitChildServices(
 611     IN PDEVICE_NODE DeviceNode,
 612     IN PVOID Context
 613 );
 614
 615 NTSTATUS
 616 IopEnumerateDevice(
 617     IN PDEVICE_OBJECT DeviceObject
 618 );
 619
 620 NTSTATUS
 621 IoCreateDriverList(
 622     VOID
 623 );
 624
 625 NTSTATUS
 626 IoDestroyDriverList(
 627     VOID
 628 );
 629
 630 NTSTATUS
 631 INIT_FUNCTION
 632 IopInitPlugPlayEvents(VOID);
 633
 634 NTSTATUS
 635 IopQueueTargetDeviceEvent(
 636     const GUID *Guid,
 637     PUNICODE_STRING DeviceIds
 638 );
 639
 640 NTSTATUS
 641 IopInitializePnpServices(
 642     IN PDEVICE_NODE DeviceNode);
 643
 644 NTSTATUS
 645 NTAPI
 646 IopOpenRegistryKeyEx(
 647     PHANDLE KeyHandle,
 648     HANDLE ParentKey,
 649     PUNICODE_STRING Name,
 650     ACCESS_MASK DesiredAccess);
 651
 652 NTSTATUS
 653 NTAPI
 654 IopGetRegistryValue(
 655     IN HANDLE Handle,
 656     IN PWSTR ValueName,
 657     OUT PKEY_VALUE_FULL_INFORMATION *Information
 658 );
 659
 660 NTSTATUS
 661 NTAPI
 662 IopCreateRegistryKeyEx(
 663     OUT PHANDLE Handle,
 664     IN HANDLE BaseHandle OPTIONAL,
 665     IN PUNICODE_STRING KeyName,
 666     IN ACCESS_MASK DesiredAccess,
 667     IN ULONG CreateOptions,
 668     OUT PULONG Disposition OPTIONAL
 669 );
 670
 671 //
 672 // PnP Routines
 673 //
 674 NTSTATUS
 675 NTAPI
 676 IopUpdateRootKey(
 677     VOID
 678 );
 679
 680 NTSTATUS
 681 NTAPI
 682 PiInitCacheGroupInformation(
 683     VOID
 684 );
 685
 686 USHORT
 687 NTAPI
 688 PpInitGetGroupOrderIndex(
 689     IN HANDLE ServiceHandle
 690 );
 691
 692 USHORT
 693 NTAPI
 694 PipGetDriverTagPriority(
 695     IN HANDLE ServiceHandle
 696 );
 697
 698 NTSTATUS
 699 NTAPI
 700 PnpRegMultiSzToUnicodeStrings(
 701     IN PKEY_VALUE_FULL_INFORMATION KeyValueInformation,
 702     OUT PUNICODE_STRING *UnicodeStringList,
 703     OUT PULONG UnicodeStringCount
 704 );
 705
 706 BOOLEAN
 707 NTAPI
 708 PnpRegSzToString(
 709     IN PWCHAR RegSzData,
 710     IN ULONG RegSzLength,
 711     OUT PUSHORT StringLength OPTIONAL
 712 );
 713
 714 //
 715 // Initialization Routines
 716 //
 717 NTSTATUS
 718 NTAPI
 719 IopCreateArcNames(
 720     IN PLOADER_PARAMETER_BLOCK LoaderBlock
 721 );
 722
 723 NTSTATUS
 724 NTAPI
 725 IopReassignSystemRoot(
 726     IN PLOADER_PARAMETER_BLOCK LoaderBlock,
 727     OUT PANSI_STRING NtBootPath
 728 );
 729
 730 BOOLEAN
 731 NTAPI
 732 IoInitSystem(
 733     IN PLOADER_PARAMETER_BLOCK LoaderBlock
 734 );
 735
 736 //
 737 // Device/Volume Routines
 738 //
 739 VOID
 740 NTAPI
 741 IopReadyDeviceObjects(
 742     IN PDRIVER_OBJECT Driver
 743 );
 744
 745 NTSTATUS
 746 FASTCALL
 747 IopInitializeDevice(
 748     IN PDEVICE_NODE DeviceNode,
 749     IN PDRIVER_OBJECT DriverObject
 750 );
 751
 752 NTSTATUS
 753 IopStartDevice(
 754     IN PDEVICE_NODE DeviceNode
 755 );
 756
 757 PVPB
 758 NTAPI
 759 IopCheckVpbMounted(
 760     IN POPEN_PACKET OpenPacket,
 761     IN PDEVICE_OBJECT DeviceObject,
 762     IN PUNICODE_STRING RemainingName,
 763     OUT PNTSTATUS Status
 764 );
 765
 766 NTSTATUS
 767 NTAPI
 768 IopMountVolume(
 769     IN PDEVICE_OBJECT DeviceObject,
 770     IN BOOLEAN AllowRawMount,
 771     IN BOOLEAN DeviceIsLocked,
 772     IN BOOLEAN Alertable,
 773     OUT PVPB *Vpb
 774 );
 775
 776 PVOID
 777 IoOpenSymlink(
 778     IN PVOID SymbolicLink
 779 );
 780
 781 PVOID
 782 IoOpenFileOnDevice(
 783     IN PVOID SymbolicLink,
 784     IN PWCHAR Name
 785 );
 786
 787 NTSTATUS
 788 NTAPI
 789 IopCreateVpb(
 790     IN PDEVICE_OBJECT DeviceObject
 791 );
 792
 793 VOID
 794 NTAPI
 795 IopDereferenceVpb(
 796     IN PVPB Vpb
 797 );
 798
 799 VOID
 800 NTAPI
 801 IoInitFileSystemImplementation(
 802     VOID
 803 );
 804
 805 VOID
 806 NTAPI
 807 IoInitVpbImplementation(
 808     VOID
 809 );
 810
 811 NTSTATUS
 812 NTAPI
 813 IopReferenceDeviceObject(
 814     IN PDEVICE_OBJECT DeviceObject
 815 );
 816
 817 VOID
 818 NTAPI
 819 IopDereferenceDeviceObject(
 820     IN PDEVICE_OBJECT DeviceObject,
 821     IN BOOLEAN ForceUnload
 822 );
 823
 824 NTSTATUS
 825 NTAPI
 826 IoGetRelatedTargetDevice(IN PFILE_OBJECT FileObject,
 827                          OUT PDEVICE_OBJECT *DeviceObject
 828 );
 829
 830 //
 831 // IRP Routines
 832 //
 833 NTSTATUS
 834 NTAPI
 835 IopCleanupFailedIrp(
 836     IN PFILE_OBJECT FileObject,
 837     IN PKEVENT EventObject,
 838     IN PVOID Buffer OPTIONAL
 839 );
 840
 841 VOID
 842 NTAPI
 843 IopAbortInterruptedIrp(
 844     IN PKEVENT EventObject,
 845     IN PIRP Irp
 846 );
 847
 848 //
 849 // Shutdown routines
 850 //
 851 VOID
 852 IoInitShutdownNotification(
 853     VOID
 854 );
 855
 856 VOID
 857 NTAPI
 858 IoShutdownSystem(
 859     IN ULONG Phase
 860 );
 861
 862 VOID
 863 NTAPI
 864 IopShutdownBaseFileSystems(
 865     IN PLIST_ENTRY ListHead
 866 );
 867
 868 //
 869 // Boot logging support
 870 //
 871 VOID
 872 IopInitBootLog(
 873     IN BOOLEAN StartBootLog
 874 );
 875
 876 VOID
 877 IopStartBootLog(
 878     VOID
 879 );
 880
 881 VOID
 882 IopStopBootLog(
 883     VOID
 884 );
 885
 886 VOID
 887 IopBootLog(
 888     IN PUNICODE_STRING DriverName,
 889     IN BOOLEAN Success
 890 );
 891
 892 VOID
 893 IopSaveBootLogToFile(
 894     VOID
 895 );
 896
 897 //
 898 // I/O Cancellation Routines
 899 //
 900 VOID
 901 NTAPI
 902 IoCancelThreadIo(
 903     IN PETHREAD Thread
 904 );
 905
 906 VOID
 907 IoInitCancelHandling(
 908     VOID
 909 );
 910
 911 //
 912 // I/O Completion
 913 //
 914 VOID
 915 NTAPI
 916 IopCompleteRequest(
 917     IN PKAPC Apc,
 918     IN PKNORMAL_ROUTINE* NormalRoutine,
 919     IN PVOID* NormalContext,
 920     IN PVOID* SystemArgument1,
 921     IN PVOID* SystemArgument2
 922 );
 923
 924 //
 925 // Error Logging Routines
 926 //
 927 VOID
 928 NTAPI
 929 IopInitErrorLog(
 930     VOID
 931 );
 932
 933 VOID
 934 NTAPI
 935 IopLogWorker(
 936     IN PVOID Parameter
 937 );
 938
 939 //
 940 // Raw File System MiniDriver
 941 //
 942 BOOLEAN
 943 RawFsIsRawFileSystemDeviceObject(
 944     IN PDEVICE_OBJECT DeviceObject
 945 );
 946
 947 NTSTATUS
 948 NTAPI
 949 RawFsDriverEntry(
 950     IN PDRIVER_OBJECT DriverObject,
 951     IN PUNICODE_STRING RegistryPath
 952 );
 953
 954 //
 955 // PnP Root MiniDriver
 956 //
 957 NTSTATUS
 958 NTAPI
 959 PnpRootDriverEntry(
 960    IN PDRIVER_OBJECT DriverObject,
 961    IN PUNICODE_STRING RegistryPath
 962 );
 963
 964 NTSTATUS
 965 PnpRootCreateDevice(
 966     IN PUNICODE_STRING ServiceName,
 967     OUT PDEVICE_OBJECT *PhysicalDeviceObject,
 968     OUT OPTIONAL PUNICODE_STRING FullInstancePath
 969 );
 970
 971 //
 972 // Driver Routines
 973 //
 974 VOID
 975 FASTCALL
 976 IopInitializeBootDrivers(
 977     VOID
 978 );
 979
 980 VOID
 981 FASTCALL
 982 IopInitializeSystemDrivers(
 983     VOID
 984 );
 985
 986 NTSTATUS
 987 NTAPI
 988 IopCreateDriver(IN PUNICODE_STRING DriverName OPTIONAL,
 989                 IN PDRIVER_INITIALIZE InitializationFunction,
 990                 IN PUNICODE_STRING RegistryPath,
 991                 IN PVOID DllBase,
 992                 IN ULONG SizeOfImage,
 993                 OUT PDRIVER_OBJECT *pDriverObject);
 994
 995 VOID
 996 NTAPI
 997 IopDeleteDriver(
 998     IN PVOID ObjectBody
 999 );
1000
1001 NTSTATUS
1002 FASTCALL
1003 IopGetDriverObject(
1004     OUT PDRIVER_OBJECT *DriverObject,
1005     IN PUNICODE_STRING ServiceName,
1006     IN BOOLEAN FileSystem
1007 );
1008
1009 NTSTATUS
1010 FASTCALL
1011 IopLoadServiceModule(
1012     IN PUNICODE_STRING ServiceName,
1013     OUT PLDR_DATA_TABLE_ENTRY *ModuleObject
1014 );
1015
1016 VOID
1017 NTAPI
1018 IopLoadUnloadDriver(
1019     IN OUT PLOAD_UNLOAD_PARAMS LoadParams
1020 );
1021
1022 NTSTATUS
1023 FASTCALL
1024 IopInitializeDriverModule(
1025     IN PDEVICE_NODE DeviceNode,
1026     IN PLDR_DATA_TABLE_ENTRY ModuleObject,
1027     IN PUNICODE_STRING ServiceName,
1028     IN BOOLEAN FileSystemDriver,
1029     OUT PDRIVER_OBJECT *DriverObject
1030 );
1031
1032 NTSTATUS
1033 FASTCALL
1034 IopAttachFilterDrivers(
1035     IN PDEVICE_NODE DeviceNode,
1036     IN BOOLEAN Lower
1037 );
1038
1039 VOID
1040 NTAPI
1041 IopReinitializeDrivers(
1042     VOID
1043 );
1044
1045 VOID
1046 NTAPI
1047 IopReinitializeBootDrivers(
1048     VOID
1049 );
1050
1051 //
1052 // File Routines
1053 //
1054 VOID
1055 NTAPI
1056 IopDeleteDevice(IN PVOID ObjectBody);
1057
1058 NTSTATUS
1059 NTAPI
1060 IopParseDevice(
1061     IN PVOID ParseObject,
1062     IN PVOID ObjectType,
1063     IN OUT PACCESS_STATE AccessState,
1064     IN KPROCESSOR_MODE AccessMode,
1065     IN ULONG Attributes,
1066     IN OUT PUNICODE_STRING CompleteName,
1067     IN OUT PUNICODE_STRING RemainingName,
1068     IN OUT PVOID Context OPTIONAL,
1069     IN PSECURITY_QUALITY_OF_SERVICE SecurityQos OPTIONAL,
1070     OUT PVOID *Object
1071 );
1072
1073 NTSTATUS
1074 NTAPI
1075 IopParseFile(
1076     IN PVOID ParseObject,
1077     IN PVOID ObjectType,
1078     IN OUT PACCESS_STATE AccessState,
1079     IN KPROCESSOR_MODE AccessMode,
1080     IN ULONG Attributes,
1081     IN OUT PUNICODE_STRING CompleteName,
1082     IN OUT PUNICODE_STRING RemainingName,
1083     IN OUT PVOID Context OPTIONAL,
1084     IN PSECURITY_QUALITY_OF_SERVICE SecurityQos OPTIONAL,
1085     OUT PVOID *Object
1086 );
1087
1088 VOID
1089 NTAPI
1090 IopDeleteFile(
1091     IN PVOID ObjectBody
1092 );
1093
1094 NTSTATUS
1095 NTAPI
1096 IopSecurityFile(
1097     IN PVOID ObjectBody,
1098     IN SECURITY_OPERATION_CODE OperationCode,
1099     IN PSECURITY_INFORMATION SecurityInformation,
1100     IN OUT PSECURITY_DESCRIPTOR SecurityDescriptor,
1101     IN OUT PULONG BufferLength,
1102     OUT PSECURITY_DESCRIPTOR *OldSecurityDescriptor,
1103     IN POOL_TYPE PoolType,
1104     IN OUT PGENERIC_MAPPING GenericMapping
1105 );
1106
1107 NTSTATUS
1108 NTAPI
1109 IopQueryNameFile(
1110     IN PVOID ObjectBody,
1111     IN BOOLEAN HasName,
1112     OUT POBJECT_NAME_INFORMATION ObjectNameInfo,
1113     IN ULONG Length,
1114     OUT PULONG ReturnLength,
1115     IN KPROCESSOR_MODE PreviousMode
1116 );
1117
1118 VOID
1119 NTAPI
1120 IopCloseFile(
1121     IN PEPROCESS Process OPTIONAL,
1122     IN PVOID Object,
1123     IN ACCESS_MASK GrantedAccess,
1124     IN ULONG ProcessHandleCount,
1125     IN ULONG SystemHandleCount
1126 );
1127
1128 //
1129 // I/O Timer Routines
1130 //
1131 VOID
1132 FASTCALL
1133 IopInitTimerImplementation(
1134     VOID
1135 );
1136
1137 VOID
1138 NTAPI
1139 IopRemoveTimerFromTimerList(
1140     IN PIO_TIMER Timer
1141 );
1142
1143 //
1144 // I/O Completion Routines
1145 //
1146 VOID
1147 NTAPI
1148 IopDeleteIoCompletion(
1149     PVOID ObjectBody
1150 );
1151
1152 //
1153 // Ramdisk Routines
1154 //
1155 NTSTATUS
1156 NTAPI
1157 IopStartRamdisk(
1158     IN PLOADER_PARAMETER_BLOCK LoaderBlock
1159 );
1160
1161 //
1162 // Global I/O Data
1163 //
1164 extern POBJECT_TYPE IoCompletionType;
1165 extern PDEVICE_NODE IopRootDeviceNode;
1166 extern KSPIN_LOCK IopDeviceTreeLock;
1167 extern ULONG IopTraceLevel;
1168 extern GENERAL_LOOKASIDE IopMdlLookasideList;
1169 extern GENERIC_MAPPING IopCompletionMapping;
1170 extern GENERIC_MAPPING IopFileMapping;
1171 extern POBJECT_TYPE _IoFileObjectType;
1172 extern HAL_DISPATCH _HalDispatchTable;
1173 extern LIST_ENTRY IopErrorLogListHead;
1174 extern ULONG IopNumTriageDumpDataBlocks;
1175 extern PVOID IopTriageDumpDataBlocks[64];
1176 extern PIO_BUS_TYPE_GUID_LIST PnpBusTypeGuidList;
1177 extern PDRIVER_OBJECT IopRootDriverObject;
1178
1179 //
1180 // Inlined Functions
1181 //
1182 #include "io_x.h"