1 /* $Id: iotypes.h,v 1.42 2002/10/03 19:26:47 robd Exp $
5 #ifndef __INCLUDE_DDK_IOTYPES_H
6 #define __INCLUDE_DDK_IOTYPES_H
12 extern POBJECT_TYPE EXPORTED IoAdapterObjectType
;
13 extern POBJECT_TYPE EXPORTED IoDeviceHandlerObjectType
;
14 extern POBJECT_TYPE EXPORTED IoDeviceObjectType
;
15 extern POBJECT_TYPE EXPORTED IoDriverObjectType
;
16 extern POBJECT_TYPE EXPORTED IoFileObjectType
;
18 extern POBJECT_TYPE IMPORTED IoAdapterObjectType
;
19 extern POBJECT_TYPE IMPORTED IoDeviceHandlerObjectType
;
20 extern POBJECT_TYPE IMPORTED IoDeviceObjectType
;
21 extern POBJECT_TYPE IMPORTED IoDriverObjectType
;
22 extern POBJECT_TYPE IMPORTED IoFileObjectType
;
26 * These are referenced before they can be fully defined
28 struct _DRIVER_OBJECT
;
30 struct _DEVICE_OBJECT
;
32 struct _IO_STATUS_BLOCK
;
33 struct _SCSI_REQUEST_BLOCK
;
35 /* SIMPLE TYPES *************************************************************/
44 typedef enum _CREATE_FILE_TYPE
47 CreateFileTypeNamedPipe
,
48 CreateFileTypeMailslot
52 typedef struct _SHARE_ACCESS
61 } SHARE_ACCESS
, *PSHARE_ACCESS
;
63 /* FUNCTION TYPES ************************************************************/
66 (*PDRIVER_REINITIALIZE
)(struct _DRIVER_OBJECT
* DriverObject
,
70 typedef NTSTATUS STDCALL
71 (*PIO_QUERY_DEVICE_ROUTINE
)(PVOID Context
,
72 PUNICODE_STRING Pathname
,
73 INTERFACE_TYPE BusType
,
75 PKEY_VALUE_FULL_INFORMATION
* BI
,
76 CONFIGURATION_TYPE ControllerType
,
77 ULONG ControllerNumber
,
78 PKEY_VALUE_FULL_INFORMATION
* CI
,
79 CONFIGURATION_TYPE PeripheralType
,
80 ULONG PeripheralNumber
,
81 PKEY_VALUE_FULL_INFORMATION
* PI
);
83 typedef NTSTATUS STDCALL
84 (*PIO_COMPLETION_ROUTINE
)(struct _DEVICE_OBJECT
* DeviceObject
,
89 (*PIO_APC_ROUTINE
)(PVOID ApcContext
,
90 struct _IO_STATUS_BLOCK
* IoStatusBlock
,
94 /* STRUCTURE TYPES ***********************************************************/
96 typedef struct _ADAPTER_OBJECT ADAPTER_OBJECT
, *PADAPTER_OBJECT
;
99 * PURPOSE: Special timer associated with each device
100 * NOTES: This is a guess
102 typedef struct _IO_TIMER
106 } IO_TIMER
, *PIO_TIMER
;
108 typedef struct _IO_SECURITY_CONTEXT
110 PSECURITY_QUALITY_OF_SERVICE SecurityQos
;
111 PACCESS_STATE AccessState
;
112 ACCESS_MASK DesiredAccess
;
113 ULONG FullCreateOptions
;
114 } IO_SECURITY_CONTEXT
, *PIO_SECURITY_CONTEXT
;
117 typedef struct _IO_RESOURCE_DESCRIPTOR
121 UCHAR ShareDisposition
;
124 * Reserved for system use
131 * Reserved for system use
141 PHYSICAL_ADDRESS MinimumAddress
;
142 PHYSICAL_ADDRESS MaximumAddress
;
148 PHYSICAL_ADDRESS MinimumAddress
;
149 PHYSICAL_ADDRESS MaximumAddress
;
158 ULONG MinimumChannel
;
159 ULONG MaximumChannel
;
162 } IO_RESOURCE_DESCRIPTOR
, *PIO_RESOURCE_DESCRIPTOR
;
164 // IO_RESOURCE_DESCRIPTOR Options
165 #define IO_RESOURCE_REQUIRED 0x00
166 #define IO_RESOURCE_PREFERRED 0x01
167 #define IO_RESOURCE_DEFAULT 0x02
168 #define IO_RESOURCE_ALTERNATIVE 0x08
170 typedef struct _IO_RESOURCE_LIST
175 IO_RESOURCE_DESCRIPTOR Descriptors
[1];
176 } IO_RESOURCE_LIST
, *PIO_RESOURCE_LIST
;
178 typedef struct _IO_RESOURCE_REQUIREMENTS_LIST
186 * System defined enum for the bus
188 INTERFACE_TYPE InterfaceType
;
193 ULONG AlternativeLists
;
194 IO_RESOURCE_LIST List
[1];
195 } IO_RESOURCE_REQUIREMENTS_LIST
, *PIO_RESOURCE_REQUIREMENTS_LIST
;
200 UCHAR ShareDisposition
;
206 PHYSICAL_ADDRESS Start
;
208 } __attribute__((packed
)) Port
;
214 } __attribute__((packed
))Interrupt
;
217 PHYSICAL_ADDRESS Start
;
219 } __attribute__((packed
))Memory
;
225 } __attribute__((packed
))Dma
;
231 } __attribute__((packed
))DeviceSpecificData
;
232 } __attribute__((packed
)) u
;
233 } __attribute__((packed
)) CM_PARTIAL_RESOURCE_DESCRIPTOR
, *PCM_PARTIAL_RESOURCE_DESCRIPTOR
;
240 CM_PARTIAL_RESOURCE_DESCRIPTOR PartialDescriptors
[1];
241 } __attribute__((packed
))CM_PARTIAL_RESOURCE_LIST
, *PCM_PARTIAL_RESOURCE_LIST
;
245 INTERFACE_TYPE InterfaceType
;
247 CM_PARTIAL_RESOURCE_LIST PartialResourceList
;
248 } __attribute__((packed
)) CM_FULL_RESOURCE_DESCRIPTOR
;
253 CM_FULL_RESOURCE_DESCRIPTOR List
[1];
254 } CM_RESOURCE_LIST
, *PCM_RESOURCE_LIST
;
258 * PURPOSE: IRP stack location
260 typedef struct __attribute__((packed
)) _IO_STACK_LOCATION
271 PIO_SECURITY_CONTEXT SecurityContext
;
273 USHORT FileAttributes
;
281 LARGE_INTEGER ByteOffset
;
287 LARGE_INTEGER ByteOffset
;
291 ULONG OutputBufferLength
;
292 ULONG InputBufferLength
;
294 PVOID Type3InputBuffer
;
298 ULONG OutputBufferLength
;
299 ULONG InputBufferLength
;
301 PVOID Type3InputBuffer
;
306 struct _DEVICE_OBJECT
* DeviceObject
;
311 struct _DEVICE_OBJECT
* DeviceObject
;
316 FILE_INFORMATION_CLASS FileInformationClass
;
321 FS_INFORMATION_CLASS FsInformationClass
;
326 FS_INFORMATION_CLASS FsInformationClass
;
331 FILE_INFORMATION_CLASS FileInformationClass
;
332 struct _FILE_OBJECT
* FileObject
;
337 BOOLEAN ReplaceIfExists
;
347 PUNICODE_STRING FileName
;
348 FILE_INFORMATION_CLASS FileInformationClass
;
352 // Parameters for IRP_MN_QUERY_DEVICE_RELATIONS
355 DEVICE_RELATION_TYPE Type
;
356 } QueryDeviceRelations
;
358 // Parameters for IRP_MN_QUERY_INTERFACE
361 CONST GUID
*InterfaceType
;
364 PINTERFACE Interface
;
365 PVOID InterfaceSpecificData
;
368 // Parameters for IRP_MN_QUERY_CAPABILITIES
371 PDEVICE_CAPABILITIES Capabilities
;
372 } DeviceCapabilities
;
374 // Parameters for IRP_MN_FILTER_RESOURCE_REQUIREMENTS
377 PIO_RESOURCE_REQUIREMENTS_LIST IoResourceRequirementList
;
378 } FilterResourceRequirements
;
380 // Parameters for IRP_MN_QUERY_ID
383 BUS_QUERY_ID_TYPE IdType
;
386 // Parameters for IRP_MN_QUERY_DEVICE_TEXT
389 DEVICE_TEXT_TYPE DeviceTextType
;
393 // Parameters for IRP_MN_DEVICE_USAGE_NOTIFICATION
398 DEVICE_USAGE_NOTIFICATION_TYPE Type
;
401 // Parameters for IRP_MN_WAIT_WAKE
404 SYSTEM_POWER_STATE PowerState
;
407 // Parameter for IRP_MN_POWER_SEQUENCE
410 PPOWER_SEQUENCE PowerSequence
;
413 // Parameters for IRP_MN_SET_POWER and IRP_MN_QUERY_POWER
417 POWER_STATE_TYPE Type
;
419 POWER_ACTION ShutdownType
;
422 // Parameters for IRP_MN_START_DEVICE
425 PCM_RESOURCE_LIST AllocatedResources
;
426 PCM_RESOURCE_LIST AllocatedResourcesTranslated
;
429 /* Parameters for IRP_MN_SCSI_CLASS */
432 struct _SCSI_REQUEST_BLOCK
*Srb
;
435 /* Paramters for other calls */
445 struct _DEVICE_OBJECT
* DeviceObject
;
446 struct _FILE_OBJECT
* FileObject
;
448 PIO_COMPLETION_ROUTINE CompletionRoutine
;
449 PVOID CompletionContext
;
451 } __attribute__((packed
)) IO_STACK_LOCATION
, *PIO_STACK_LOCATION
;
454 typedef struct _IO_STATUS_BLOCK
458 } IO_STATUS_BLOCK
, *PIO_STATUS_BLOCK
;
461 typedef struct _IO_PIPE_CREATE_BUFFER
463 BOOLEAN WriteModeMessage
;
464 BOOLEAN ReadModeMessage
;
469 LARGE_INTEGER TimeOut
;
470 } IO_PIPE_CREATE_BUFFER
, *PIO_PIPE_CREATE_BUFFER
;
473 typedef struct _IO_MAILSLOT_CREATE_BUFFER
475 ULONG Param
; /* ?? */
476 ULONG MaxMessageSize
;
477 LARGE_INTEGER TimeOut
;
478 } IO_MAILSLOT_CREATE_BUFFER
, *PIO_MAILSLOT_CREATE_BUFFER
;
482 * Driver entry point declaration
484 typedef NTSTATUS STDCALL
485 (*PDRIVER_INITIALIZE
)(struct _DRIVER_OBJECT
* DriverObject
,
486 PUNICODE_STRING RegistryPath
);
489 * Driver cancel declaration
491 typedef NTSTATUS STDCALL
492 (*PDRIVER_CANCEL
)(struct _DEVICE_OBJECT
* DeviceObject
,
493 struct _IRP
* RegistryPath
);
496 typedef struct _SECTION_OBJECT_POINTERS
498 PVOID DataSectionObject
;
499 PVOID SharedCacheMap
;
500 PVOID ImageSectionObject
;
501 } SECTION_OBJECT_POINTERS
, *PSECTION_OBJECT_POINTERS
;
503 typedef struct _IO_COMPLETION_CONTEXT
507 } IO_COMPLETION_CONTEXT
, *PIO_COMPLETION_CONTEXT
;
509 #define FO_FILE_OPEN 0x00000001
510 #define FO_SYNCHRONOUS_IO 0x00000002
511 #define FO_ALERTABLE_IO 0x00000004
512 #define FO_NO_INTERMEDIATE_BUFFERING 0x00000008
513 #define FO_WRITE_THROUGH 0x00000010
514 #define FO_SEQUENTIAL_ONLY 0x00000020
515 #define FO_CACHE_SUPPORTED 0x00000040
516 #define FO_NAMED_PIPE 0x00000080
517 #define FO_STREAM_FILE 0x00000100
518 #define FO_MAILSLOT 0x00000200
519 #define FO_GENERATE_AUDIT_ON_CLOSE 0x00000400
520 #define FO_DIRECT_DEVICE_OPEN 0x00000800
521 #define FO_FILE_MODIFIED 0x00001000
522 #define FO_FILE_SIZE_CHANGED 0x00002000
523 #define FO_CLEANUP_COMPLETE 0x00004000
524 #define FO_TEMPORARY_FILE 0x00008000
525 #define FO_DELETE_ON_CLOSE 0x00010000
526 #define FO_OPENED_CASE_SENSITIVE 0x00020000
527 #define FO_HANDLE_CREATED 0x00040000
528 #define FO_FILE_FAST_IO_READ 0x00080000
531 * ReactOS specific flags
533 #define FO_DIRECT_CACHE_READ 0x72000001
534 #define FO_DIRECT_CACHE_WRITE 0x72000002
535 #define FO_DIRECT_CACHE_PAGING_READ 0x72000004
536 #define FO_DIRECT_CACHE_PAGING_WRITE 0x72000008
537 #define FO_FCB_IS_VALID 0x72000010
539 typedef struct _FILE_OBJECT
543 struct _DEVICE_OBJECT
* DeviceObject
;
547 PSECTION_OBJECT_POINTERS SectionObjectPointers
;
548 PVOID PrivateCacheMap
;
549 NTSTATUS FinalStatus
;
550 struct _FILE_OBJECT
* RelatedFileObject
;
551 BOOLEAN LockOperation
;
552 BOOLEAN DeletePending
;
555 BOOLEAN DeleteAccess
;
558 BOOLEAN SharedDelete
;
560 UNICODE_STRING FileName
;
561 LARGE_INTEGER CurrentByteOffset
;
567 PIO_COMPLETION_CONTEXT CompletionContext
;
568 } FILE_OBJECT
, *PFILE_OBJECT
;
579 struct _IRP
* MasterIrp
;
583 LIST_ENTRY ThreadListEntry
;
584 IO_STATUS_BLOCK IoStatus
;
585 KPROCESSOR_MODE RequestorMode
;
586 BOOLEAN PendingReturned
;
588 CHAR CurrentLocation
;
591 CCHAR ApcEnvironment
;// CCHAR or PVOID?
592 UCHAR AllocationFlags
;//UCHAR or ULONG?
593 PIO_STATUS_BLOCK UserIosb
;
599 PIO_APC_ROUTINE UserApcRoutine
;
600 PVOID UserApcContext
;
601 } AsynchronousParameters
;
602 LARGE_INTEGER AllocationSize
;
604 PDRIVER_CANCEL CancelRoutine
;
611 KDEVICE_QUEUE_ENTRY DeviceQueueEntry
;
612 PVOID DriverContext
[4];
614 struct _ETHREAD
* Thread
;
615 PCHAR AuxiliaryBuffer
;
616 LIST_ENTRY ListEntry
;
617 struct _IO_STACK_LOCATION
* CurrentStackLocation
;
618 PFILE_OBJECT OriginalFileObject
;
623 IO_STACK_LOCATION Stack
[1];
626 #define VPB_MOUNTED 0x00000001
627 #define VPB_LOCKED 0x00000002
628 #define VPB_PERSISTENT 0x00000004
629 #define VPB_REMOVE_PENDING 0x00000008
636 USHORT VolumeLabelLength
;
637 struct _DEVICE_OBJECT
* DeviceObject
;
638 struct _DEVICE_OBJECT
* RealDevice
;
640 ULONG ReferenceCount
;
641 WCHAR VolumeLabel
[MAXIMUM_VOLUME_LABEL_LENGTH
];
645 typedef struct _DEVICE_OBJECT
650 struct _DRIVER_OBJECT
* DriverObject
;
651 struct _DEVICE_OBJECT
* NextDevice
;
652 struct _DEVICE_OBJECT
* AttachedDevice
;
653 struct _IRP
* CurrentIrp
;
656 ULONG Characteristics
;
658 PVOID DeviceExtension
;
659 DEVICE_TYPE DeviceType
;
664 WAIT_CONTEXT_BLOCK Wcb
;
666 ULONG AlignmentRequirement
;
667 KDEVICE_QUEUE DeviceQueue
;
669 ULONG ActiveThreadCount
;
670 PSECURITY_DESCRIPTOR SecurityDescriptor
;
674 struct _DEVOBJ_EXTENSION
* DeviceObjectExtension
;
676 } DEVICE_OBJECT
, *PDEVICE_OBJECT
;
680 * Fast i/o routine type declaration
682 //typedef NTSTATUS (*PFAST_IO_DISPATCH)(struct _DEVICE_OBJECT*, IRP*);
683 //FIXME : this type is ok for read and write, but not for all routines
684 typedef BOOLEAN STDCALL
685 (*PFAST_IO_ROUTINE
)(IN
struct _FILE_OBJECT
*FileObject
,
686 IN PLARGE_INTEGER FileOffset
,
691 OUT PIO_STATUS_BLOCK IoStatus
,
692 IN
struct _DEVICE_OBJECT
*DeviceObject
);
694 typedef struct _FAST_IO_DISPATCH
{
695 ULONG SizeOfFastIoDispatch
;
696 PFAST_IO_ROUTINE FastIoCheckIfPossible
;
697 PFAST_IO_ROUTINE FastIoRead
;
698 PFAST_IO_ROUTINE FastIoWrite
;
699 PFAST_IO_ROUTINE FastIoQueryBasicInfo
;
700 PFAST_IO_ROUTINE FastIoQueryStandardInfo
;
701 PFAST_IO_ROUTINE FastIoLock
;
702 PFAST_IO_ROUTINE FastIoUnlockSingle
;
703 PFAST_IO_ROUTINE FastIoUnlockAll
;
704 PFAST_IO_ROUTINE FastIoUnlockAllByKey
;
705 PFAST_IO_ROUTINE FastIoDeviceControl
;
706 PFAST_IO_ROUTINE AcquireFileForNtCreateSection
;
707 PFAST_IO_ROUTINE ReleaseFileForNtCreateSection
;
708 PFAST_IO_ROUTINE FastIoDetachDevice
;
709 PFAST_IO_ROUTINE FastIoQueryNetworkOpenInfo
;
710 PFAST_IO_ROUTINE AcquireForModWrite
;
711 PFAST_IO_ROUTINE MdlRead
;
712 PFAST_IO_ROUTINE MdlReadComplete
;
713 PFAST_IO_ROUTINE PrepareMdlWrite
;
714 PFAST_IO_ROUTINE MdlWriteComplete
;
715 PFAST_IO_ROUTINE FastIoReadCompressed
;
716 PFAST_IO_ROUTINE FastIoWriteCompressed
;
717 PFAST_IO_ROUTINE MdlReadCompleteCompressed
;
718 PFAST_IO_ROUTINE MdlWriteCompleteCompressed
;
719 PFAST_IO_ROUTINE FastIoQueryOpen
;
720 PFAST_IO_ROUTINE ReleaseForModWrite
;
721 PFAST_IO_ROUTINE AcquireForCcFlush
;
722 PFAST_IO_ROUTINE ReleaseForCcFlush
;
723 } FAST_IO_DISPATCH
, *PFAST_IO_DISPATCH
;
726 * Dispatch routine type declaration
728 typedef NTSTATUS STDCALL
729 (*PDRIVER_DISPATCH
)(IN
struct _DEVICE_OBJECT
*DeviceObject
,
730 IN
struct _IRP
*Irp
);
733 * StartIo routine type declaration
736 (*PDRIVER_STARTIO
)(IN PDEVICE_OBJECT DeviceObject
,
740 * Unload routine type declaration
743 (*PDRIVER_UNLOAD
)(IN
struct _DRIVER_OBJECT
*DriverObject
);
746 * AddDevice routine type declaration
748 typedef NTSTATUS STDCALL
749 (*PDRIVER_ADD_DEVICE
)(IN
struct _DRIVER_OBJECT
*DriverObject
,
750 IN
struct _DEVICE_OBJECT
*PhysicalDeviceObject
);
753 typedef struct _DRIVER_EXTENSION
755 struct _DRIVER_OBJECT
* DriverObject
;
756 PDRIVER_ADD_DEVICE AddDevice
;
758 UNICODE_STRING ServiceKeyName
;
759 } DRIVER_EXTENSION
, *PDRIVER_EXTENSION
;
763 struct _FAST_IO_DISPATCH_TABLE
766 PFAST_IO_DISPATCH Dispatch
;
768 } FAST_IO_DISPATCH_TABLE
, * PFAST_IO_DISPATCH_TABLE
;
771 typedef struct _DRIVER_OBJECT
775 PDEVICE_OBJECT DeviceObject
;
780 PDRIVER_EXTENSION DriverExtension
;
781 UNICODE_STRING DriverName
;
782 PUNICODE_STRING HardwareDatabase
;
784 PFAST_IO_DISPATCH_TABLE FastIoDispatch
;
786 PFAST_IO_DISPATCH FastIoDispatch
;
788 PDRIVER_INITIALIZE DriverInit
;
789 PDRIVER_STARTIO DriverStartIo
;
790 PDRIVER_UNLOAD DriverUnload
;
791 PDRIVER_DISPATCH MajorFunction
[IRP_MJ_MAXIMUM_FUNCTION
+ 1];
792 } DRIVER_OBJECT
, *PDRIVER_OBJECT
;
795 typedef struct _CONFIGURATION_INFORMATION
804 BOOLEAN AtDiskPrimaryAddressClaimed
;
805 BOOLEAN AtDiskSecondaryAddressClaimed
;
806 } CONFIGURATION_INFORMATION
, *PCONFIGURATION_INFORMATION
;
809 (*PIO_DPC_ROUTINE
)(PKDPC Dpc
,
810 PDEVICE_OBJECT DeviceObject
,
815 (*PIO_TIMER_ROUTINE
)(PDEVICE_OBJECT DeviceObject
,
818 #if WINDOWS_STRUCTS_DOESNT_ALREADY_DEFINE_THIS
819 typedef struct _PARTITION_INFORMATION
821 LARGE_INTEGER StartingOffset
;
822 LARGE_INTEGER PartitionLength
;
824 ULONG PartitionNumber
;
826 BOOLEAN BootIndicator
;
827 BOOLEAN RecognizedPartition
;
828 BOOLEAN RewritePartition
;
829 } PARTITION_INFORMATION
, *PPARTITION_INFORMATION
;
832 typedef struct _DRIVER_LAYOUT_INFORMATION
834 ULONG PartitionCount
;
836 PARTITION_INFORMATION PartitionEntry
[1];
837 } DRIVER_LAYOUT_INFORMATION
, *PDRIVER_LAYOUT_INFORMATION
;
840 typedef IO_ALLOCATION_ACTION STDCALL
841 (*PDRIVER_CONTROL
)(PDEVICE_OBJECT DeviceObject
,
843 PVOID MapRegisterBase
,
845 #if (_WIN32_WINNT >= 0x0400)
847 (*PFSDNOTIFICATIONPROC
)(IN PDEVICE_OBJECT PtrTargetFileSystemDeviceObject
,
848 IN BOOLEAN DriverActive
);
849 #endif // (_WIN32_WINNT >= 0x0400)
851 #endif /* __INCLUDE_DDK_IOTYPES_H */