4 * Windows NT WDM Driver Developer Kit
6 * This file is part of the ReactOS DDK package.
9 * Amine Khaldi (amine.khaldi@reactos.org)
10 * Timo Kreuzer (timo.kreuzer@reactos.org)
12 * THIS SOFTWARE IS NOT COPYRIGHTED
14 * This source code is offered for use in the public domain. You may
15 * use, modify or distribute it freely.
17 * This code is distributed in the hope that it will be useful but
18 * WITHOUT ANY WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY
19 * DISCLAIMED. This includes but is not limited to warranties of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
28 #define WDM_MAJORVERSION 0x06
29 #define WDM_MINORVERSION 0x00
31 /* Included via ntddk.h? */
34 #define _WDM_INCLUDED_
36 #define NO_INTERLOCKED_INTRINSICS
44 #include <kernelspecs.h>
54 #endif /* _INC_STRING */
60 typedef GUID UOW
, *PUOW
;
65 #if (NTDDI_VERSION >= NTDDI_WINXP)
71 __internal_kernel_driver
72 __drv_Mode_impl(WDM_INCLUDED
)
78 #if !defined(_NTHALDLL_) && !defined(_BLDR_)
79 #define NTHALAPI DECLSPEC_IMPORT
85 #if !defined(_NTOSKRNL_) && !defined(_BLDR_) && !defined(_NTSYSTEM_)
86 #define NTKERNELAPI DECLSPEC_IMPORT
94 #if defined(_X86_) && !defined(_NTHAL_)
95 #define _DECL_HAL_KE_IMPORT DECLSPEC_IMPORT
97 #define _DECL_HAL_KE_IMPORT
99 #define _DECL_HAL_KE_IMPORT NTKERNELAPI
103 #define POINTER_ALIGNMENT DECLSPEC_ALIGN(8)
105 #define POINTER_ALIGNMENT
108 /* Helper macro to enable gcc's extension. */
109 #ifndef __GNU_EXTENSION
111 #define __GNU_EXTENSION __extension__
113 #define __GNU_EXTENSION
117 #if defined(_MSC_VER)
119 /* Disable some warnings */
120 #pragma warning(disable:4115) /* Named type definition in parentheses */
121 #pragma warning(disable:4201) /* Nameless unions and structs */
122 #pragma warning(disable:4214) /* Bit fields of other types than int */
123 #pragma warning(disable:4820) /* Padding added, due to alignment requirement */
125 /* Indicate if #pragma alloc_text() is supported */
126 #if defined(_M_IX86) || defined(_M_AMD64) || defined(_M_IA64)
127 #define ALLOC_PRAGMA 1
130 /* Indicate if #pragma data_seg() is supported */
131 #if defined(_M_IX86) || defined(_M_AMD64)
132 #define ALLOC_DATA_PRAGMA 1
135 #endif /* _MSC_VER */
137 /* These macros are used to create aliases for imported data. We need to do
138 this to have declarations that are compatible with MS DDK */
140 #define __SYMBOL(_Name) "_"#_Name
141 #define __IMPORTSYMBOL(_Name) "__imp__"#_Name
142 #define __IMPORTNAME(_Name) _imp__##_Name
144 #define __SYMBOL(_Name) #_Name
145 #define __IMPORTSYMBOL(_Name) "__imp_"#_Name
146 #define __IMPORTNAME(_Name) __imp_##_Name
149 #define __CREATE_NTOS_DATA_IMPORT_ALIAS(_Name) \
150 __pragma(comment(linker, "/alternatename:"__SYMBOL(_Name) "=" __IMPORTSYMBOL(_Name)))
151 #else /* !_MSC_VER */
153 #define __STRINGIFY(_exp) #_exp
155 #define _Pragma_redefine_extname(_Name, _Target) _Pragma(__STRINGIFY(redefine_extname _Name _Target))
156 #define __CREATE_NTOS_DATA_IMPORT_ALIAS(_Name) \
157 _Pragma_redefine_extname(_Name,__IMPORTNAME(_Name))
161 #if !defined(USE_DMA_MACROS) && !defined(_NTHAL_)
162 #define USE_DMA_MACROS
164 #if !defined(NO_LEGACY_DRIVERS) && !defined(__REACTOS__)
165 #define NO_LEGACY_DRIVERS
167 #endif /* defined(_WIN64) */
169 /* Forward declarations */
176 struct _DEVICE_OBJECT
;
177 struct _DRIVER_OBJECT
;
178 struct _IO_STATUS_BLOCK
;
179 struct _DEVICE_DESCRIPTION
;
180 struct _SCATTER_GATHER_LIST
;
181 struct _DRIVE_LAYOUT_INFORMATION
;
182 struct _COMPRESSED_DATA_INFO
;
183 struct _IO_RESOURCE_DESCRIPTOR
;
185 /* Structures not exposed to drivers */
186 typedef struct _OBJECT_TYPE
*POBJECT_TYPE
;
187 typedef struct _HAL_DISPATCH_TABLE
*PHAL_DISPATCH_TABLE
;
188 typedef struct _HAL_PRIVATE_DISPATCH_TABLE
*PHAL_PRIVATE_DISPATCH_TABLE
;
189 typedef struct _CALLBACK_OBJECT
*PCALLBACK_OBJECT
;
190 typedef struct _EPROCESS
*PEPROCESS
;
191 typedef struct _ETHREAD
*PETHREAD
;
192 typedef struct _IO_TIMER
*PIO_TIMER
;
193 typedef struct _KINTERRUPT
*PKINTERRUPT
;
194 typedef struct _KPROCESS
*PKPROCESS
;
195 typedef struct _KTHREAD
*PKTHREAD
, *PRKTHREAD
;
196 typedef struct _CONTEXT
*PCONTEXT
;
198 #if defined(USE_DMA_MACROS) && !defined(_NTHAL_)
199 typedef struct _DMA_ADAPTER
*PADAPTER_OBJECT
;
200 #elif defined(_WDM_INCLUDED_)
201 typedef struct _DMA_ADAPTER
*PADAPTER_OBJECT
;
203 typedef struct _ADAPTER_OBJECT
*PADAPTER_OBJECT
;
206 #ifndef DEFINE_GUIDEX
208 #define DEFINE_GUIDEX(name) EXTERN_C const CDECL GUID name
210 #define DEFINE_GUIDEX(name) EXTERN_C const GUID name
212 #endif /* DEFINE_GUIDEX */
215 #define STATICGUIDOF(guid) STATIC_##guid
218 /* GUID Comparison */
219 #ifndef __IID_ALIGNED__
220 #define __IID_ALIGNED__
222 inline int IsEqualGUIDAligned(REFGUID guid1
, REFGUID guid2
)
224 return ( (*(PLONGLONG
)(&guid1
) == *(PLONGLONG
)(&guid2
)) &&
225 (*((PLONGLONG
)(&guid1
) + 1) == *((PLONGLONG
)(&guid2
) + 1)) );
228 #define IsEqualGUIDAligned(guid1, guid2) \
229 ( (*(PLONGLONG)(guid1) == *(PLONGLONG)(guid2)) && \
230 (*((PLONGLONG)(guid1) + 1) == *((PLONGLONG)(guid2) + 1)) )
231 #endif /* __cplusplus */
232 #endif /* !__IID_ALIGNED__ */
235 /******************************************************************************
236 * INTERLOCKED Functions *
237 ******************************************************************************/
239 // Intrinsics (note: taken from our winnt.h)
242 #if defined(__GNUC__)
244 static __inline__ BOOLEAN
245 InterlockedBitTestAndSet(
246 _Inout_updates_bytes_((Bit
+7)/8) _Interlocked_operand_ LONG
volatile *Base
,
251 __asm__
__volatile__("lock "
254 :"=r" (OldBit
),"+m" (*Base
)
259 return (_InterlockedOr(Base
, 1 << Bit
) >> Bit
) & 1;
263 static __inline__ BOOLEAN
264 InterlockedBitTestAndReset(
265 _Inout_updates_bytes_((Bit
+7)/8) _Interlocked_operand_ LONG
volatile *Base
,
270 __asm__
__volatile__("lock "
273 :"=r" (OldBit
),"+m" (*Base
)
278 return (_InterlockedAnd(Base
, ~(1 << Bit
)) >> Bit
) & 1;
282 #endif /* defined(__GNUC__) */
284 #define BitScanForward _BitScanForward
285 #define BitScanReverse _BitScanReverse
286 #define BitTest _bittest
287 #define BitTestAndComplement _bittestandcomplement
288 #define BitTestAndSet _bittestandset
289 #define BitTestAndReset _bittestandreset
290 #define InterlockedBitTestAndSet _interlockedbittestandset
291 #define InterlockedBitTestAndReset _interlockedbittestandreset
294 #define BitScanForward64 _BitScanForward64
295 #define BitScanReverse64 _BitScanReverse64
296 #define BitTest64 _bittest64
297 #define BitTestAndComplement64 _bittestandcomplement64
298 #define BitTestAndSet64 _bittestandset64
299 #define BitTestAndReset64 _bittestandreset64
300 #define InterlockedBitTestAndSet64 _interlockedbittestandset64
301 #define InterlockedBitTestAndReset64 _interlockedbittestandreset64
304 #if !defined(__INTERLOCKED_DECLARED)
305 #define __INTERLOCKED_DECLARED
308 #if defined(NO_INTERLOCKED_INTRINSICS)
312 InterlockedIncrement(
313 _Inout_ _Interlocked_operand_ LONG
volatile *Addend
);
318 InterlockedDecrement(
319 _Inout_ _Interlocked_operand_ LONG
volatile *Addend
);
324 InterlockedCompareExchange(
325 _Inout_ _Interlocked_operand_ LONG
volatile *Destination
,
327 _In_ LONG Comparand
);
333 _Inout_ _Interlocked_operand_ LONG
volatile *Destination
,
339 InterlockedExchangeAdd(
340 _Inout_ _Interlocked_operand_ LONG
volatile *Addend
,
343 #else /* !defined(NO_INTERLOCKED_INTRINSICS) */
345 #define InterlockedExchange _InterlockedExchange
346 #define InterlockedIncrement _InterlockedIncrement
347 #define InterlockedDecrement _InterlockedDecrement
348 #define InterlockedExchangeAdd _InterlockedExchangeAdd
349 #define InterlockedCompareExchange _InterlockedCompareExchange
350 #define InterlockedOr _InterlockedOr
351 #define InterlockedAnd _InterlockedAnd
352 #define InterlockedXor _InterlockedXor
354 #endif /* !defined(NO_INTERLOCKED_INTRINSICS) */
356 #endif /* defined (_X86_) */
358 #if !defined (_WIN64)
361 * InterlockedExchangePointer(
362 * IN OUT PVOID volatile *Target,
365 #define InterlockedExchangePointer(Target, Value) \
366 ((PVOID) InterlockedExchange((PLONG) Target, (LONG) Value))
370 * InterlockedCompareExchangePointer(
371 * IN OUT PVOID *Destination,
373 * IN PVOID Comparand)
375 #define InterlockedCompareExchangePointer(Destination, Exchange, Comparand) \
376 ((PVOID) InterlockedCompareExchange((PLONG) Destination, (LONG) Exchange, (LONG) Comparand))
378 #define InterlockedExchangeAddSizeT(a, b) InterlockedExchangeAdd((LONG *)a, b)
379 #define InterlockedIncrementSizeT(a) InterlockedIncrement((LONG *)a)
380 #define InterlockedDecrementSizeT(a) InterlockedDecrement((LONG *)a)
382 #endif // !defined (_WIN64)
384 #if defined (_M_AMD64)
386 #define InterlockedExchangeAddSizeT(a, b) InterlockedExchangeAdd64((LONGLONG *)a, (LONGLONG)b)
387 #define InterlockedIncrementSizeT(a) InterlockedIncrement64((LONGLONG *)a)
388 #define InterlockedDecrementSizeT(a) InterlockedDecrement64((LONGLONG *)a)
389 #define InterlockedAnd _InterlockedAnd
390 #define InterlockedOr _InterlockedOr
391 #define InterlockedXor _InterlockedXor
392 #define InterlockedIncrement _InterlockedIncrement
393 #define InterlockedDecrement _InterlockedDecrement
394 #define InterlockedAdd _InterlockedAdd
395 #define InterlockedExchange _InterlockedExchange
396 #define InterlockedExchangeAdd _InterlockedExchangeAdd
397 #define InterlockedCompareExchange _InterlockedCompareExchange
398 #define InterlockedAnd64 _InterlockedAnd64
399 #define InterlockedOr64 _InterlockedOr64
400 #define InterlockedXor64 _InterlockedXor64
401 #define InterlockedIncrement64 _InterlockedIncrement64
402 #define InterlockedDecrement64 _InterlockedDecrement64
403 #define InterlockedAdd64 _InterlockedAdd64
404 #define InterlockedExchange64 _InterlockedExchange64
405 #define InterlockedExchangeAdd64 _InterlockedExchangeAdd64
406 #define InterlockedCompareExchange64 _InterlockedCompareExchange64
407 #define InterlockedCompareExchangePointer _InterlockedCompareExchangePointer
408 #define InterlockedExchangePointer _InterlockedExchangePointer
409 #define InterlockedBitTestAndSet64 _interlockedbittestandset64
410 #define InterlockedBitTestAndReset64 _interlockedbittestandreset64
414 #if defined(_M_AMD64) && !defined(RC_INVOKED) && !defined(MIDL_PASS)
415 //#if !defined(_X86AMD64_) // FIXME: what's _X86AMD64_ used for?
419 _Inout_ _Interlocked_operand_ LONG64
volatile *Addend
,
422 return InterlockedExchangeAdd64(Addend
, Value
) + Value
;
427 #endif /* !__INTERLOCKED_DECLARED */
430 /******************************************************************************
431 * Runtime Library Types *
432 ******************************************************************************/
434 #define RTL_REGISTRY_ABSOLUTE 0
435 #define RTL_REGISTRY_SERVICES 1
436 #define RTL_REGISTRY_CONTROL 2
437 #define RTL_REGISTRY_WINDOWS_NT 3
438 #define RTL_REGISTRY_DEVICEMAP 4
439 #define RTL_REGISTRY_USER 5
440 #define RTL_REGISTRY_MAXIMUM 6
441 #define RTL_REGISTRY_HANDLE 0x40000000
442 #define RTL_REGISTRY_OPTIONAL 0x80000000
444 /* RTL_QUERY_REGISTRY_TABLE.Flags */
445 #define RTL_QUERY_REGISTRY_SUBKEY 0x00000001
446 #define RTL_QUERY_REGISTRY_TOPKEY 0x00000002
447 #define RTL_QUERY_REGISTRY_REQUIRED 0x00000004
448 #define RTL_QUERY_REGISTRY_NOVALUE 0x00000008
449 #define RTL_QUERY_REGISTRY_NOEXPAND 0x00000010
450 #define RTL_QUERY_REGISTRY_DIRECT 0x00000020
451 #define RTL_QUERY_REGISTRY_DELETE 0x00000040
453 #define HASH_STRING_ALGORITHM_DEFAULT 0
454 #define HASH_STRING_ALGORITHM_X65599 1
455 #define HASH_STRING_ALGORITHM_INVALID 0xffffffff
457 typedef struct _RTL_BITMAP
{
460 } RTL_BITMAP
, *PRTL_BITMAP
;
462 typedef struct _RTL_BITMAP_RUN
{
465 } RTL_BITMAP_RUN
, *PRTL_BITMAP_RUN
;
467 _Function_class_(RTL_QUERY_REGISTRY_ROUTINE
)
468 _IRQL_requires_max_(PASSIVE_LEVEL
)
471 (NTAPI
*PRTL_QUERY_REGISTRY_ROUTINE
)(
472 _In_z_ PWSTR ValueName
,
473 _In_ ULONG ValueType
,
474 _In_reads_bytes_opt_(ValueLength
) PVOID ValueData
,
475 _In_ ULONG ValueLength
,
476 _In_opt_ PVOID Context
,
477 _In_opt_ PVOID EntryContext
);
479 typedef struct _RTL_QUERY_REGISTRY_TABLE
{
480 PRTL_QUERY_REGISTRY_ROUTINE QueryRoutine
;
487 } RTL_QUERY_REGISTRY_TABLE
, *PRTL_QUERY_REGISTRY_TABLE
;
489 typedef struct _TIME_FIELDS
{
498 } TIME_FIELDS
, *PTIME_FIELDS
;
501 #ifndef _SLIST_HEADER_
502 #define _SLIST_HEADER_
506 typedef struct DECLSPEC_ALIGN(16) _SLIST_ENTRY
{
507 struct _SLIST_ENTRY
*Next
;
508 } SLIST_ENTRY
, *PSLIST_ENTRY
;
510 typedef struct _SLIST_ENTRY32
{
512 } SLIST_ENTRY32
, *PSLIST_ENTRY32
;
514 typedef union DECLSPEC_ALIGN(16) _SLIST_HEADER
{
515 _ANONYMOUS_STRUCT
struct {
521 ULONGLONG Sequence
:9;
522 ULONGLONG NextEntry
:39;
523 ULONGLONG HeaderType
:1;
525 ULONGLONG Reserved
:59;
530 ULONGLONG Sequence
:48;
531 ULONGLONG HeaderType
:1;
533 ULONGLONG Reserved
:2;
534 ULONGLONG NextEntry
:60;
538 ULONGLONG Sequence
:48;
539 ULONGLONG HeaderType
:1;
540 ULONGLONG Reserved
:3;
541 ULONGLONG NextEntry
:60;
543 } SLIST_HEADER
, *PSLIST_HEADER
;
545 typedef union _SLIST_HEADER32
{
547 _ANONYMOUS_STRUCT
struct {
552 } SLIST_HEADER32
, *PSLIST_HEADER32
;
556 #define SLIST_ENTRY SINGLE_LIST_ENTRY
557 #define _SLIST_ENTRY _SINGLE_LIST_ENTRY
558 #define PSLIST_ENTRY PSINGLE_LIST_ENTRY
560 typedef SLIST_ENTRY SLIST_ENTRY32
, *PSLIST_ENTRY32
;
562 typedef union _SLIST_HEADER
{
564 _ANONYMOUS_STRUCT
struct {
569 } SLIST_HEADER
, *PSLIST_HEADER
;
571 typedef SLIST_HEADER SLIST_HEADER32
, *PSLIST_HEADER32
;
573 #endif /* defined(_WIN64) */
575 #endif /* _SLIST_HEADER_ */
577 /* Exception record flags */
578 #define EXCEPTION_NONCONTINUABLE 0x01
579 #define EXCEPTION_UNWINDING 0x02
580 #define EXCEPTION_EXIT_UNWIND 0x04
581 #define EXCEPTION_STACK_INVALID 0x08
582 #define EXCEPTION_NESTED_CALL 0x10
583 #define EXCEPTION_TARGET_UNWIND 0x20
584 #define EXCEPTION_COLLIDED_UNWIND 0x40
585 #define EXCEPTION_UNWIND (EXCEPTION_UNWINDING | EXCEPTION_EXIT_UNWIND | \
586 EXCEPTION_TARGET_UNWIND | EXCEPTION_COLLIDED_UNWIND)
588 #define IS_UNWINDING(Flag) ((Flag & EXCEPTION_UNWIND) != 0)
589 #define IS_DISPATCHING(Flag) ((Flag & EXCEPTION_UNWIND) == 0)
590 #define IS_TARGET_UNWIND(Flag) (Flag & EXCEPTION_TARGET_UNWIND)
592 #define EXCEPTION_MAXIMUM_PARAMETERS 15
594 /* Exception records */
595 typedef struct _EXCEPTION_RECORD
{
596 NTSTATUS ExceptionCode
;
597 ULONG ExceptionFlags
;
598 struct _EXCEPTION_RECORD
*ExceptionRecord
;
599 PVOID ExceptionAddress
;
600 ULONG NumberParameters
;
601 ULONG_PTR ExceptionInformation
[EXCEPTION_MAXIMUM_PARAMETERS
];
602 } EXCEPTION_RECORD
, *PEXCEPTION_RECORD
;
604 typedef struct _EXCEPTION_RECORD32
{
605 NTSTATUS ExceptionCode
;
606 ULONG ExceptionFlags
;
607 ULONG ExceptionRecord
;
608 ULONG ExceptionAddress
;
609 ULONG NumberParameters
;
610 ULONG ExceptionInformation
[EXCEPTION_MAXIMUM_PARAMETERS
];
611 } EXCEPTION_RECORD32
, *PEXCEPTION_RECORD32
;
613 typedef struct _EXCEPTION_RECORD64
{
614 NTSTATUS ExceptionCode
;
615 ULONG ExceptionFlags
;
616 ULONG64 ExceptionRecord
;
617 ULONG64 ExceptionAddress
;
618 ULONG NumberParameters
;
619 ULONG __unusedAlignment
;
620 ULONG64 ExceptionInformation
[EXCEPTION_MAXIMUM_PARAMETERS
];
621 } EXCEPTION_RECORD64
, *PEXCEPTION_RECORD64
;
623 typedef struct _EXCEPTION_POINTERS
{
624 PEXCEPTION_RECORD ExceptionRecord
;
625 PCONTEXT ContextRecord
;
626 } EXCEPTION_POINTERS
, *PEXCEPTION_POINTERS
;
629 extern BOOLEAN NlsMbCodePageTag
;
630 #define NLS_MB_CODE_PAGE_TAG NlsMbCodePageTag
631 extern BOOLEAN NlsMbOemCodePageTag
;
632 #define NLS_MB_OEM_CODE_PAGE_TAG NlsMbOemCodePageTag
634 extern BOOLEAN
*NlsMbCodePageTag
;
635 __CREATE_NTOS_DATA_IMPORT_ALIAS(NlsMbCodePageTag
)
636 #define NLS_MB_CODE_PAGE_TAG (*NlsMbCodePageTag)
637 extern BOOLEAN
*NlsMbOemCodePageTag
;
638 __CREATE_NTOS_DATA_IMPORT_ALIAS(NlsMbOemCodePageTag
)
639 #define NLS_MB_OEM_CODE_PAGE_TAG (*NlsMbOemCodePageTag)
642 #define SHORT_LEAST_SIGNIFICANT_BIT 0
643 #define SHORT_MOST_SIGNIFICANT_BIT 1
645 #define LONG_LEAST_SIGNIFICANT_BIT 0
646 #define LONG_3RD_MOST_SIGNIFICANT_BIT 1
647 #define LONG_2ND_MOST_SIGNIFICANT_BIT 2
648 #define LONG_MOST_SIGNIFICANT_BIT 3
650 #define RTLVERLIB_DDI(x) Wdmlib##x
653 (*PFN_RTL_IS_NTDDI_VERSION_AVAILABLE
)(
657 (*PFN_RTL_IS_SERVICE_PACK_VERSION_INSTALLED
)(
660 typedef struct _OSVERSIONINFOA
{
661 ULONG dwOSVersionInfoSize
;
662 ULONG dwMajorVersion
;
663 ULONG dwMinorVersion
;
666 CHAR szCSDVersion
[128];
667 } OSVERSIONINFOA
, *POSVERSIONINFOA
, *LPOSVERSIONINFOA
;
669 typedef struct _OSVERSIONINFOW
{
670 ULONG dwOSVersionInfoSize
;
671 ULONG dwMajorVersion
;
672 ULONG dwMinorVersion
;
675 WCHAR szCSDVersion
[128];
676 } OSVERSIONINFOW
, *POSVERSIONINFOW
, *LPOSVERSIONINFOW
, RTL_OSVERSIONINFOW
, *PRTL_OSVERSIONINFOW
;
678 typedef struct _OSVERSIONINFOEXA
{
679 ULONG dwOSVersionInfoSize
;
680 ULONG dwMajorVersion
;
681 ULONG dwMinorVersion
;
684 CHAR szCSDVersion
[128];
685 USHORT wServicePackMajor
;
686 USHORT wServicePackMinor
;
690 } OSVERSIONINFOEXA
, *POSVERSIONINFOEXA
, *LPOSVERSIONINFOEXA
;
692 typedef struct _OSVERSIONINFOEXW
{
693 ULONG dwOSVersionInfoSize
;
694 ULONG dwMajorVersion
;
695 ULONG dwMinorVersion
;
698 WCHAR szCSDVersion
[128];
699 USHORT wServicePackMajor
;
700 USHORT wServicePackMinor
;
704 } OSVERSIONINFOEXW
, *POSVERSIONINFOEXW
, *LPOSVERSIONINFOEXW
, RTL_OSVERSIONINFOEXW
, *PRTL_OSVERSIONINFOEXW
;
707 typedef OSVERSIONINFOEXW OSVERSIONINFOEX
;
708 typedef POSVERSIONINFOEXW POSVERSIONINFOEX
;
709 typedef LPOSVERSIONINFOEXW LPOSVERSIONINFOEX
;
710 typedef OSVERSIONINFOW OSVERSIONINFO
;
711 typedef POSVERSIONINFOW POSVERSIONINFO
;
712 typedef LPOSVERSIONINFOW LPOSVERSIONINFO
;
714 typedef OSVERSIONINFOEXA OSVERSIONINFOEX
;
715 typedef POSVERSIONINFOEXA POSVERSIONINFOEX
;
716 typedef LPOSVERSIONINFOEXA LPOSVERSIONINFOEX
;
717 typedef OSVERSIONINFOA OSVERSIONINFO
;
718 typedef POSVERSIONINFOA POSVERSIONINFO
;
719 typedef LPOSVERSIONINFOA LPOSVERSIONINFO
;
722 /******************************************************************************
724 ******************************************************************************/
726 typedef UCHAR KIRQL
, *PKIRQL
;
727 typedef CCHAR KPROCESSOR_MODE
;
728 typedef LONG KPRIORITY
;
736 #define CACHE_FULLY_ASSOCIATIVE 0xFF
737 #define MAXIMUM_SUSPEND_COUNT MAXCHAR
739 #define EVENT_QUERY_STATE (0x0001)
740 #define EVENT_MODIFY_STATE (0x0002)
741 #define EVENT_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0x3)
743 #define LTP_PC_SMT 0x1
745 #if (NTDDI_VERSION < NTDDI_WIN7) || defined(_X86_) || !defined(NT_PROCESSOR_GROUPS)
746 #define SINGLE_GROUP_LEGACY_API 1
749 #define SEMAPHORE_QUERY_STATE (0x0001)
750 #define SEMAPHORE_MODIFY_STATE (0x0002)
751 #define SEMAPHORE_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0x3)
753 typedef enum _LOGICAL_PROCESSOR_RELATIONSHIP
{
754 RelationProcessorCore
,
757 RelationProcessorPackage
,
760 } LOGICAL_PROCESSOR_RELATIONSHIP
;
762 typedef enum _PROCESSOR_CACHE_TYPE
{
767 } PROCESSOR_CACHE_TYPE
;
769 typedef struct _CACHE_DESCRIPTOR
{
774 PROCESSOR_CACHE_TYPE Type
;
775 } CACHE_DESCRIPTOR
, *PCACHE_DESCRIPTOR
;
777 typedef struct _SYSTEM_LOGICAL_PROCESSOR_INFORMATION
{
778 ULONG_PTR ProcessorMask
;
779 LOGICAL_PROCESSOR_RELATIONSHIP Relationship
;
780 _ANONYMOUS_UNION
union {
787 CACHE_DESCRIPTOR Cache
;
788 ULONGLONG Reserved
[2];
790 } SYSTEM_LOGICAL_PROCESSOR_INFORMATION
, *PSYSTEM_LOGICAL_PROCESSOR_INFORMATION
;
792 typedef struct _PROCESSOR_RELATIONSHIP
{
796 _Field_size_(GroupCount
) GROUP_AFFINITY GroupMask
[ANYSIZE_ARRAY
];
797 } PROCESSOR_RELATIONSHIP
, *PPROCESSOR_RELATIONSHIP
;
799 typedef struct _NUMA_NODE_RELATIONSHIP
{
802 GROUP_AFFINITY GroupMask
;
803 } NUMA_NODE_RELATIONSHIP
, *PNUMA_NODE_RELATIONSHIP
;
805 typedef struct _CACHE_RELATIONSHIP
{
810 PROCESSOR_CACHE_TYPE Type
;
812 GROUP_AFFINITY GroupMask
;
813 } CACHE_RELATIONSHIP
, *PCACHE_RELATIONSHIP
;
815 typedef struct _PROCESSOR_GROUP_INFO
{
816 UCHAR MaximumProcessorCount
;
817 UCHAR ActiveProcessorCount
;
819 KAFFINITY ActiveProcessorMask
;
820 } PROCESSOR_GROUP_INFO
, *PPROCESSOR_GROUP_INFO
;
822 typedef struct _GROUP_RELATIONSHIP
{
823 USHORT MaximumGroupCount
;
824 USHORT ActiveGroupCount
;
826 PROCESSOR_GROUP_INFO GroupInfo
[ANYSIZE_ARRAY
];
827 } GROUP_RELATIONSHIP
, *PGROUP_RELATIONSHIP
;
829 typedef struct _SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX
{
830 LOGICAL_PROCESSOR_RELATIONSHIP Relationship
;
832 _ANONYMOUS_UNION
union {
833 PROCESSOR_RELATIONSHIP Processor
;
834 NUMA_NODE_RELATIONSHIP NumaNode
;
835 CACHE_RELATIONSHIP Cache
;
836 GROUP_RELATIONSHIP Group
;
838 } SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX
, *PSYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX
;;
840 /* Processor features */
841 #define PF_FLOATING_POINT_PRECISION_ERRATA 0
842 #define PF_FLOATING_POINT_EMULATED 1
843 #define PF_COMPARE_EXCHANGE_DOUBLE 2
844 #define PF_MMX_INSTRUCTIONS_AVAILABLE 3
845 #define PF_PPC_MOVEMEM_64BIT_OK 4
846 #define PF_ALPHA_BYTE_INSTRUCTIONS 5
847 #define PF_XMMI_INSTRUCTIONS_AVAILABLE 6
848 #define PF_3DNOW_INSTRUCTIONS_AVAILABLE 7
849 #define PF_RDTSC_INSTRUCTION_AVAILABLE 8
850 #define PF_PAE_ENABLED 9
851 #define PF_XMMI64_INSTRUCTIONS_AVAILABLE 10
852 #define PF_SSE_DAZ_MODE_AVAILABLE 11
853 #define PF_NX_ENABLED 12
854 #define PF_SSE3_INSTRUCTIONS_AVAILABLE 13
855 #define PF_COMPARE_EXCHANGE128 14
856 #define PF_COMPARE64_EXCHANGE128 15
857 #define PF_CHANNELS_ENABLED 16
858 #define PF_XSAVE_ENABLED 17
860 #define MAXIMUM_WAIT_OBJECTS 64
862 #define ASSERT_APC(Object) NT_ASSERT((Object)->Type == ApcObject)
864 #define ASSERT_DPC(Object) \
865 ASSERT(((Object)->Type == 0) || \
866 ((Object)->Type == DpcObject) || \
867 ((Object)->Type == ThreadedDpcObject))
869 #define ASSERT_GATE(object) \
870 NT_ASSERT((((object)->Header.Type & KOBJECT_TYPE_MASK) == GateObject) || \
871 (((object)->Header.Type & KOBJECT_TYPE_MASK) == EventSynchronizationObject))
873 #define ASSERT_DEVICE_QUEUE(Object) \
874 NT_ASSERT((Object)->Type == DeviceQueueObject)
876 #define ASSERT_TIMER(E) \
877 NT_ASSERT(((E)->Header.Type == TimerNotificationObject) || \
878 ((E)->Header.Type == TimerSynchronizationObject))
880 #define ASSERT_MUTANT(E) \
881 NT_ASSERT((E)->Header.Type == MutantObject)
883 #define ASSERT_SEMAPHORE(E) \
884 NT_ASSERT((E)->Header.Type == SemaphoreObject)
886 #define ASSERT_EVENT(E) \
887 NT_ASSERT(((E)->Header.Type == NotificationEvent) || \
888 ((E)->Header.Type == SynchronizationEvent))
891 #define DPC_THREADED 1
893 #define GM_LOCK_BIT 0x1
894 #define GM_LOCK_BIT_V 0x0
895 #define GM_LOCK_WAITER_WOKEN 0x2
896 #define GM_LOCK_WAITER_INC 0x4
898 #define LOCK_QUEUE_WAIT_BIT 0
899 #define LOCK_QUEUE_OWNER_BIT 1
901 #define LOCK_QUEUE_WAIT 1
902 #define LOCK_QUEUE_OWNER 2
903 #define LOCK_QUEUE_TIMER_LOCK_SHIFT 4
904 #define LOCK_QUEUE_TIMER_TABLE_LOCKS (1 << (8 - LOCK_QUEUE_TIMER_LOCK_SHIFT))
906 #define PROCESSOR_FEATURE_MAX 64
908 #define DBG_STATUS_CONTROL_C 1
909 #define DBG_STATUS_SYSRQ 2
910 #define DBG_STATUS_BUGCHECK_FIRST 3
911 #define DBG_STATUS_BUGCHECK_SECOND 4
912 #define DBG_STATUS_FATAL 5
913 #define DBG_STATUS_DEBUG_CONTROL 6
914 #define DBG_STATUS_WORKER 7
917 #define MAXIMUM_PROC_PER_GROUP 64
919 #define MAXIMUM_PROC_PER_GROUP 32
921 #define MAXIMUM_PROCESSORS MAXIMUM_PROC_PER_GROUP
923 #define EXCEPTION_DIVIDED_BY_ZERO 0
924 #define EXCEPTION_DEBUG 1
925 #define EXCEPTION_NMI 2
926 #define EXCEPTION_INT3 3
927 #define EXCEPTION_BOUND_CHECK 5
928 #define EXCEPTION_INVALID_OPCODE 6
929 #define EXCEPTION_NPX_NOT_AVAILABLE 7
930 #define EXCEPTION_DOUBLE_FAULT 8
931 #define EXCEPTION_NPX_OVERRUN 9
932 #define EXCEPTION_INVALID_TSS 0x0A
933 #define EXCEPTION_SEGMENT_NOT_PRESENT 0x0B
934 #define EXCEPTION_STACK_FAULT 0x0C
935 #define EXCEPTION_GP_FAULT 0x0D
936 #define EXCEPTION_RESERVED_TRAP 0x0F
937 #define EXCEPTION_NPX_ERROR 0x010
938 #define EXCEPTION_ALIGNMENT_CHECK 0x011
940 typedef enum _KBUGCHECK_CALLBACK_REASON
{
943 KbCallbackSecondaryDumpData
,
946 } KBUGCHECK_CALLBACK_REASON
;
948 struct _KBUGCHECK_REASON_CALLBACK_RECORD
;
950 _Function_class_(KBUGCHECK_REASON_CALLBACK_ROUTINE
)
953 (NTAPI KBUGCHECK_REASON_CALLBACK_ROUTINE
)(
954 _In_ KBUGCHECK_CALLBACK_REASON Reason
,
955 _In_
struct _KBUGCHECK_REASON_CALLBACK_RECORD
*Record
,
956 _Inout_ PVOID ReasonSpecificData
,
957 _In_ ULONG ReasonSpecificDataLength
);
958 typedef KBUGCHECK_REASON_CALLBACK_ROUTINE
*PKBUGCHECK_REASON_CALLBACK_ROUTINE
;
960 typedef struct _KBUGCHECK_ADD_PAGES
{
961 _Inout_ PVOID Context
;
963 _In_ ULONG BugCheckCode
;
964 _Out_ ULONG_PTR Address
;
965 _Out_ ULONG_PTR Count
;
966 } KBUGCHECK_ADD_PAGES
, *PKBUGCHECK_ADD_PAGES
;
968 typedef struct _KBUGCHECK_SECONDARY_DUMP_DATA
{
970 _In_ ULONG InBufferLength
;
971 _In_ ULONG MaximumAllowed
;
973 _Out_ PVOID OutBuffer
;
974 _Out_ ULONG OutBufferLength
;
975 } KBUGCHECK_SECONDARY_DUMP_DATA
, *PKBUGCHECK_SECONDARY_DUMP_DATA
;
977 typedef enum _KBUGCHECK_DUMP_IO_TYPE
{
981 KbDumpIoSecondaryData
,
983 } KBUGCHECK_DUMP_IO_TYPE
;
985 typedef struct _KBUGCHECK_DUMP_IO
{
988 _In_ ULONG BufferLength
;
989 _In_ KBUGCHECK_DUMP_IO_TYPE Type
;
990 } KBUGCHECK_DUMP_IO
, *PKBUGCHECK_DUMP_IO
;
992 #define KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS 0x00000001UL
993 #define KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS 0x00000002UL
994 #define KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST 0x80000000UL
996 typedef struct _KBUGCHECK_REASON_CALLBACK_RECORD
{
998 PKBUGCHECK_REASON_CALLBACK_ROUTINE CallbackRoutine
;
1001 KBUGCHECK_CALLBACK_REASON Reason
;
1003 } KBUGCHECK_REASON_CALLBACK_RECORD
, *PKBUGCHECK_REASON_CALLBACK_RECORD
;
1005 typedef enum _KBUGCHECK_BUFFER_DUMP_STATE
{
1011 } KBUGCHECK_BUFFER_DUMP_STATE
;
1013 _Function_class_(KBUGCHECK_CALLBACK_ROUTINE
)
1014 _IRQL_requires_same_
1016 (NTAPI KBUGCHECK_CALLBACK_ROUTINE
)(
1019 typedef KBUGCHECK_CALLBACK_ROUTINE
*PKBUGCHECK_CALLBACK_ROUTINE
;
1021 typedef struct _KBUGCHECK_CALLBACK_RECORD
{
1023 PKBUGCHECK_CALLBACK_ROUTINE CallbackRoutine
;
1024 _Field_size_bytes_opt_(Length
) PVOID Buffer
;
1029 } KBUGCHECK_CALLBACK_RECORD
, *PKBUGCHECK_CALLBACK_RECORD
;
1031 _Function_class_(NMI_CALLBACK
)
1032 _IRQL_requires_same_
1034 (NTAPI NMI_CALLBACK
)(
1035 _In_opt_ PVOID Context
,
1036 _In_ BOOLEAN Handled
);
1037 typedef NMI_CALLBACK
*PNMI_CALLBACK
;
1039 typedef enum _KE_PROCESSOR_CHANGE_NOTIFY_STATE
{
1040 KeProcessorAddStartNotify
= 0,
1041 KeProcessorAddCompleteNotify
,
1042 KeProcessorAddFailureNotify
1043 } KE_PROCESSOR_CHANGE_NOTIFY_STATE
;
1045 typedef struct _KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT
{
1046 KE_PROCESSOR_CHANGE_NOTIFY_STATE State
;
1049 #if (NTDDI_VERSION >= NTDDI_WIN7)
1050 PROCESSOR_NUMBER ProcNumber
;
1052 } KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT
, *PKE_PROCESSOR_CHANGE_NOTIFY_CONTEXT
;
1054 _IRQL_requires_same_
1055 _Function_class_(PROCESSOR_CALLBACK_FUNCTION
)
1057 (NTAPI PROCESSOR_CALLBACK_FUNCTION
)(
1058 _In_ PVOID CallbackContext
,
1059 _In_ PKE_PROCESSOR_CHANGE_NOTIFY_CONTEXT ChangeContext
,
1060 _Inout_ PNTSTATUS OperationStatus
);
1061 typedef PROCESSOR_CALLBACK_FUNCTION
*PPROCESSOR_CALLBACK_FUNCTION
;
1063 #define KE_PROCESSOR_CHANGE_ADD_EXISTING 1
1065 #define INVALID_PROCESSOR_INDEX 0xffffffff
1067 typedef enum _KINTERRUPT_POLARITY
{
1068 InterruptPolarityUnknown
,
1069 InterruptActiveHigh
,
1071 } KINTERRUPT_POLARITY
, *PKINTERRUPT_POLARITY
;
1073 typedef enum _KPROFILE_SOURCE
{
1075 ProfileAlignmentFixup
,
1078 ProfileLoadInstructions
,
1079 ProfilePipelineFrozen
,
1080 ProfileBranchInstructions
,
1081 ProfileTotalNonissues
,
1082 ProfileDcacheMisses
,
1083 ProfileIcacheMisses
,
1085 ProfileBranchMispredictions
,
1086 ProfileStoreInstructions
,
1087 ProfileFpInstructions
,
1088 ProfileIntegerInstructions
,
1092 ProfileSpecialInstructions
,
1094 ProfileIcacheIssues
,
1095 ProfileDcacheAccesses
,
1096 ProfileMemoryBarrierCycles
,
1097 ProfileLoadLinkedIssues
,
1101 typedef enum _KWAIT_REASON
{
1142 typedef struct _KWAIT_BLOCK
{
1143 LIST_ENTRY WaitListEntry
;
1144 struct _KTHREAD
*Thread
;
1146 struct _KWAIT_BLOCK
*NextWaitBlock
;
1149 #if (NTDDI_VERSION >= NTDDI_WIN7)
1150 volatile UCHAR BlockState
;
1157 } KWAIT_BLOCK
, *PKWAIT_BLOCK
, *PRKWAIT_BLOCK
;
1159 typedef enum _KINTERRUPT_MODE
{
1164 #define THREAD_WAIT_OBJECTS 3
1166 _IRQL_requires_same_
1167 _Function_class_(KSTART_ROUTINE
)
1169 (NTAPI KSTART_ROUTINE
)(
1170 _In_ PVOID StartContext
);
1171 typedef KSTART_ROUTINE
*PKSTART_ROUTINE
;
1174 (NTAPI
*PKINTERRUPT_ROUTINE
)(
1177 _Function_class_(KSERVICE_ROUTINE
)
1178 _IRQL_requires_(HIGH_LEVEL
)
1179 _IRQL_requires_same_
1181 (NTAPI KSERVICE_ROUTINE
)(
1182 _In_
struct _KINTERRUPT
*Interrupt
,
1183 _In_ PVOID ServiceContext
);
1184 typedef KSERVICE_ROUTINE
*PKSERVICE_ROUTINE
;
1186 _Function_class_(KMESSAGE_SERVICE_ROUTINE
)
1187 _IRQL_requires_same_
1189 (NTAPI KMESSAGE_SERVICE_ROUTINE
)(
1190 _In_
struct _KINTERRUPT
*Interrupt
,
1191 _In_ PVOID ServiceContext
,
1192 _In_ ULONG MessageID
);
1193 typedef KMESSAGE_SERVICE_ROUTINE
*PKMESSAGE_SERVICE_ROUTINE
;
1195 typedef enum _KD_OPTION
{
1196 KD_OPTION_SET_BLOCK_ENABLE
,
1200 (NTAPI
*PKNORMAL_ROUTINE
)(
1201 IN PVOID NormalContext OPTIONAL
,
1202 IN PVOID SystemArgument1 OPTIONAL
,
1203 IN PVOID SystemArgument2 OPTIONAL
);
1206 (NTAPI
*PKRUNDOWN_ROUTINE
)(
1207 IN
struct _KAPC
*Apc
);
1210 (NTAPI
*PKKERNEL_ROUTINE
)(
1211 IN
struct _KAPC
*Apc
,
1212 IN OUT PKNORMAL_ROUTINE
*NormalRoutine OPTIONAL
,
1213 IN OUT PVOID
*NormalContext OPTIONAL
,
1214 IN OUT PVOID
*SystemArgument1 OPTIONAL
,
1215 IN OUT PVOID
*SystemArgument2 OPTIONAL
);
1217 typedef struct _KAPC
{
1223 struct _KTHREAD
*Thread
;
1224 LIST_ENTRY ApcListEntry
;
1225 PKKERNEL_ROUTINE KernelRoutine
;
1226 PKRUNDOWN_ROUTINE RundownRoutine
;
1227 PKNORMAL_ROUTINE NormalRoutine
;
1228 PVOID NormalContext
;
1229 PVOID SystemArgument1
;
1230 PVOID SystemArgument2
;
1231 CCHAR ApcStateIndex
;
1232 KPROCESSOR_MODE ApcMode
;
1234 } KAPC
, *PKAPC
, *RESTRICTED_POINTER PRKAPC
;
1236 #define KAPC_OFFSET_TO_SPARE_BYTE0 FIELD_OFFSET(KAPC, SpareByte0)
1237 #define KAPC_OFFSET_TO_SPARE_BYTE1 FIELD_OFFSET(KAPC, SpareByte1)
1238 #define KAPC_OFFSET_TO_SPARE_LONG FIELD_OFFSET(KAPC, SpareLong0)
1239 #define KAPC_OFFSET_TO_SYSTEMARGUMENT1 FIELD_OFFSET(KAPC, SystemArgument1)
1240 #define KAPC_OFFSET_TO_SYSTEMARGUMENT2 FIELD_OFFSET(KAPC, SystemArgument2)
1241 #define KAPC_OFFSET_TO_APCSTATEINDEX FIELD_OFFSET(KAPC, ApcStateIndex)
1242 #define KAPC_ACTUAL_LENGTH (FIELD_OFFSET(KAPC, Inserted) + sizeof(BOOLEAN))
1244 typedef struct _KDEVICE_QUEUE_ENTRY
{
1245 LIST_ENTRY DeviceListEntry
;
1248 } KDEVICE_QUEUE_ENTRY
, *PKDEVICE_QUEUE_ENTRY
,
1249 *RESTRICTED_POINTER PRKDEVICE_QUEUE_ENTRY
;
1251 typedef PVOID PKIPI_CONTEXT
;
1254 (NTAPI
*PKIPI_WORKER
)(
1255 IN OUT PKIPI_CONTEXT PacketContext
,
1256 IN PVOID Parameter1 OPTIONAL
,
1257 IN PVOID Parameter2 OPTIONAL
,
1258 IN PVOID Parameter3 OPTIONAL
);
1260 typedef struct _KIPI_COUNTS
{
1265 ULONG FlushSingleTb
;
1266 ULONG FlushMultipleTb
;
1267 ULONG FlushEntireTb
;
1272 ULONG SweepIcacheRange
;
1273 ULONG FlushIoBuffers
;
1274 ULONG GratuitousDPC
;
1275 } KIPI_COUNTS
, *PKIPI_COUNTS
;
1277 _IRQL_requires_same_
1278 _Function_class_(KIPI_BROADCAST_WORKER
)
1279 _IRQL_requires_(IPI_LEVEL
)
1281 (NTAPI KIPI_BROADCAST_WORKER
)(
1282 _In_ ULONG_PTR Argument
);
1283 typedef KIPI_BROADCAST_WORKER
*PKIPI_BROADCAST_WORKER
;
1285 typedef ULONG_PTR KSPIN_LOCK
, *PKSPIN_LOCK
;
1287 typedef struct _KSPIN_LOCK_QUEUE
{
1288 struct _KSPIN_LOCK_QUEUE
*volatile Next
;
1289 PKSPIN_LOCK
volatile Lock
;
1290 } KSPIN_LOCK_QUEUE
, *PKSPIN_LOCK_QUEUE
;
1292 typedef struct _KLOCK_QUEUE_HANDLE
{
1293 KSPIN_LOCK_QUEUE LockQueue
;
1295 } KLOCK_QUEUE_HANDLE
, *PKLOCK_QUEUE_HANDLE
;
1297 #if defined(_AMD64_)
1299 typedef ULONG64 KSPIN_LOCK_QUEUE_NUMBER
;
1301 #define LockQueueDispatcherLock 0
1302 #define LockQueueExpansionLock 1
1303 #define LockQueuePfnLock 2
1304 #define LockQueueSystemSpaceLock 3
1305 #define LockQueueVacbLock 4
1306 #define LockQueueMasterLock 5
1307 #define LockQueueNonPagedPoolLock 6
1308 #define LockQueueIoCancelLock 7
1309 #define LockQueueWorkQueueLock 8
1310 #define LockQueueIoVpbLock 9
1311 #define LockQueueIoDatabaseLock 10
1312 #define LockQueueIoCompletionLock 11
1313 #define LockQueueNtfsStructLock 12
1314 #define LockQueueAfdWorkQueueLock 13
1315 #define LockQueueBcbLock 14
1316 #define LockQueueMmNonPagedPoolLock 15
1317 #define LockQueueUnusedSpare16 16
1318 #define LockQueueTimerTableLock 17
1319 #define LockQueueMaximumLock (LockQueueTimerTableLock + LOCK_QUEUE_TIMER_TABLE_LOCKS)
1323 typedef enum _KSPIN_LOCK_QUEUE_NUMBER
{
1324 LockQueueDispatcherLock
,
1325 LockQueueExpansionLock
,
1327 LockQueueSystemSpaceLock
,
1329 LockQueueMasterLock
,
1330 LockQueueNonPagedPoolLock
,
1331 LockQueueIoCancelLock
,
1332 LockQueueWorkQueueLock
,
1334 LockQueueIoDatabaseLock
,
1335 LockQueueIoCompletionLock
,
1336 LockQueueNtfsStructLock
,
1337 LockQueueAfdWorkQueueLock
,
1339 LockQueueMmNonPagedPoolLock
,
1340 LockQueueUnusedSpare16
,
1341 LockQueueTimerTableLock
,
1342 LockQueueMaximumLock
= LockQueueTimerTableLock
+ LOCK_QUEUE_TIMER_TABLE_LOCKS
1343 } KSPIN_LOCK_QUEUE_NUMBER
, *PKSPIN_LOCK_QUEUE_NUMBER
;
1345 #endif /* defined(_AMD64_) */
1347 _Function_class_(KDEFERRED_ROUTINE
)
1348 _IRQL_requires_(DISPATCH_LEVEL
)
1349 _IRQL_requires_same_
1351 (NTAPI KDEFERRED_ROUTINE
)(
1352 _In_
struct _KDPC
*Dpc
,
1353 _In_opt_ PVOID DeferredContext
,
1354 _In_opt_ PVOID SystemArgument1
,
1355 _In_opt_ PVOID SystemArgument2
);
1356 typedef KDEFERRED_ROUTINE
*PKDEFERRED_ROUTINE
;
1358 typedef enum _KDPC_IMPORTANCE
{
1362 MediumHighImportance
1365 typedef struct _KDPC
{
1368 volatile USHORT Number
;
1369 LIST_ENTRY DpcListEntry
;
1370 PKDEFERRED_ROUTINE DeferredRoutine
;
1371 PVOID DeferredContext
;
1372 PVOID SystemArgument1
;
1373 PVOID SystemArgument2
;
1374 volatile PVOID DpcData
;
1375 } KDPC
, *PKDPC
, *RESTRICTED_POINTER PRKDPC
;
1377 typedef struct _KDPC_WATCHDOG_INFORMATION
{
1380 ULONG DpcWatchdogLimit
;
1381 ULONG DpcWatchdogCount
;
1383 } KDPC_WATCHDOG_INFORMATION
, *PKDPC_WATCHDOG_INFORMATION
;
1385 typedef struct _KDEVICE_QUEUE
{
1388 LIST_ENTRY DeviceListHead
;
1390 # if defined(_AMD64_)
1391 _ANONYMOUS_UNION
union {
1393 _ANONYMOUS_STRUCT
struct {
1401 } KDEVICE_QUEUE
, *PKDEVICE_QUEUE
, *RESTRICTED_POINTER PRKDEVICE_QUEUE
;
1403 #define TIMER_EXPIRED_INDEX_BITS 6
1404 #define TIMER_PROCESSOR_INDEX_BITS 5
1406 typedef struct _DISPATCHER_HEADER
{
1407 _ANONYMOUS_UNION
union {
1408 _ANONYMOUS_STRUCT
struct {
1410 _ANONYMOUS_UNION
union {
1411 _ANONYMOUS_UNION
union {
1412 UCHAR TimerControlFlags
;
1413 _ANONYMOUS_STRUCT
struct {
1415 UCHAR Coalescable
:1;
1416 UCHAR KeepShifting
:1;
1417 UCHAR EncodedTolerableDelay
:5;
1421 #if (NTDDI_VERSION < NTDDI_WIN7)
1426 _ANONYMOUS_UNION
union {
1427 _ANONYMOUS_UNION
union {
1428 UCHAR ThreadControlFlags
;
1429 _ANONYMOUS_STRUCT
struct {
1430 UCHAR CpuThrottled
:1;
1431 UCHAR CycleProfiling
:1;
1432 UCHAR CounterProfiling
:1;
1439 _ANONYMOUS_UNION
union {
1440 #if (NTDDI_VERSION >= NTDDI_WIN7)
1441 _ANONYMOUS_UNION
union {
1442 UCHAR TimerMiscFlags
;
1443 _ANONYMOUS_STRUCT
struct {
1445 UCHAR Index
:TIMER_EXPIRED_INDEX_BITS
;
1448 UCHAR Processor
:TIMER_PROCESSOR_INDEX_BITS
;
1451 volatile UCHAR Expired
:1;
1455 /* Pre Win7 compatibility fix to latest WDK */
1458 _ANONYMOUS_UNION
union {
1459 BOOLEAN DebugActive
;
1460 _ANONYMOUS_STRUCT
struct {
1461 BOOLEAN ActiveDR7
:1;
1462 BOOLEAN Instrumented
:1;
1463 BOOLEAN Reserved2
:4;
1464 BOOLEAN UmsScheduled
:1;
1465 BOOLEAN UmsPrimary
:1;
1467 } DUMMYUNIONNAME
; /* should probably be DUMMYUNIONNAME2, but this is what WDK says */
1474 LIST_ENTRY WaitListHead
;
1475 } DISPATCHER_HEADER
, *PDISPATCHER_HEADER
;
1477 typedef struct _KEVENT
{
1478 DISPATCHER_HEADER Header
;
1479 } KEVENT
, *PKEVENT
, *RESTRICTED_POINTER PRKEVENT
;
1481 typedef struct _KSEMAPHORE
{
1482 DISPATCHER_HEADER Header
;
1484 } KSEMAPHORE
, *PKSEMAPHORE
, *RESTRICTED_POINTER PRKSEMAPHORE
;
1486 #define KSEMAPHORE_ACTUAL_LENGTH (FIELD_OFFSET(KSEMAPHORE, Limit) + sizeof(LONG))
1488 typedef struct _KGATE
{
1489 DISPATCHER_HEADER Header
;
1490 } KGATE
, *PKGATE
, *RESTRICTED_POINTER PRKGATE
;
1492 typedef struct _KGUARDED_MUTEX
{
1493 volatile LONG Count
;
1497 _ANONYMOUS_UNION
union {
1498 _ANONYMOUS_STRUCT
struct {
1499 SHORT KernelApcDisable
;
1500 SHORT SpecialApcDisable
;
1502 ULONG CombinedApcDisable
;
1504 } KGUARDED_MUTEX
, *PKGUARDED_MUTEX
;
1506 typedef struct _KMUTANT
{
1507 DISPATCHER_HEADER Header
;
1508 LIST_ENTRY MutantListEntry
;
1509 struct _KTHREAD
*RESTRICTED_POINTER OwnerThread
;
1512 } KMUTANT
, *PKMUTANT
, *RESTRICTED_POINTER PRKMUTANT
, KMUTEX
, *PKMUTEX
, *RESTRICTED_POINTER PRKMUTEX
;
1514 #define TIMER_TABLE_SIZE 512
1515 #define TIMER_TABLE_SHIFT 9
1517 typedef struct _KTIMER
{
1518 DISPATCHER_HEADER Header
;
1519 ULARGE_INTEGER DueTime
;
1520 LIST_ENTRY TimerListEntry
;
1522 #if (NTDDI_VERSION >= NTDDI_WIN7) && !defined(_X86_)
1526 } KTIMER
, *PKTIMER
, *RESTRICTED_POINTER PRKTIMER
;
1528 typedef enum _LOCK_OPERATION
{
1534 #define KTIMER_ACTUAL_LENGTH (FIELD_OFFSET(KTIMER, Period) + sizeof(LONG))
1536 _Function_class_(KSYNCHRONIZE_ROUTINE
)
1537 _IRQL_requires_same_
1539 (NTAPI KSYNCHRONIZE_ROUTINE
)(
1540 _In_ PVOID SynchronizeContext
);
1541 typedef KSYNCHRONIZE_ROUTINE
*PKSYNCHRONIZE_ROUTINE
;
1543 typedef enum _POOL_TYPE
{
1546 NonPagedPoolMustSucceed
,
1548 NonPagedPoolCacheAligned
,
1549 PagedPoolCacheAligned
,
1550 NonPagedPoolCacheAlignedMustS
,
1552 NonPagedPoolSession
= 32,
1554 NonPagedPoolMustSucceedSession
,
1555 DontUseThisTypeSession
,
1556 NonPagedPoolCacheAlignedSession
,
1557 PagedPoolCacheAlignedSession
,
1558 NonPagedPoolCacheAlignedMustSSession
1561 typedef enum _ALTERNATIVE_ARCHITECTURE_TYPE
{
1565 } ALTERNATIVE_ARCHITECTURE_TYPE
;
1570 #define IsNEC_98 (FALSE)
1574 #define IsNotNEC_98 (TRUE)
1581 #ifndef SetNotNEC_98
1582 #define SetNotNEC_98
1587 typedef struct _KSYSTEM_TIME
{
1591 } KSYSTEM_TIME
, *PKSYSTEM_TIME
;
1593 typedef struct DECLSPEC_ALIGN(16) _M128A
{
1598 typedef struct DECLSPEC_ALIGN(16) _XSAVE_FORMAT
{
1605 USHORT ErrorSelector
;
1608 USHORT DataSelector
;
1612 M128A FloatRegisters
[8];
1614 M128A XmmRegisters
[16];
1615 UCHAR Reserved4
[96];
1617 M128A XmmRegisters
[8];
1618 UCHAR Reserved4
[192];
1619 ULONG StackControl
[7];
1622 } XSAVE_FORMAT
, *PXSAVE_FORMAT
;
1624 typedef struct DECLSPEC_ALIGN(8) _XSAVE_AREA_HEADER
{
1626 ULONG64 Reserved
[7];
1627 } XSAVE_AREA_HEADER
, *PXSAVE_AREA_HEADER
;
1629 typedef struct DECLSPEC_ALIGN(16) _XSAVE_AREA
{
1630 XSAVE_FORMAT LegacyState
;
1631 XSAVE_AREA_HEADER Header
;
1632 } XSAVE_AREA
, *PXSAVE_AREA
;
1634 typedef struct _XSTATE_CONTEXT
{
1638 _Field_size_bytes_opt_(Length
) PXSAVE_AREA Area
;
1646 } XSTATE_CONTEXT
, *PXSTATE_CONTEXT
;
1648 typedef struct _XSTATE_SAVE
{
1649 #if defined(_AMD64_)
1650 struct _XSTATE_SAVE
* Prev
;
1651 struct _KTHREAD
* Thread
;
1653 XSTATE_CONTEXT XStateContext
;
1654 #elif defined(_IA64_) || defined(_ARM_)
1656 #elif defined(_X86_)
1657 _ANONYMOUS_UNION
union {
1658 _ANONYMOUS_STRUCT
struct {
1661 struct _XSTATE_SAVE
* Prev
;
1662 PXSAVE_AREA Reserved3
;
1663 struct _KTHREAD
* Thread
;
1667 XSTATE_CONTEXT XStateContext
;
1670 } XSTATE_SAVE
, *PXSTATE_SAVE
;
1674 #define MAXIMUM_SUPPORTED_EXTENSION 512
1676 #if !defined(__midl) && !defined(MIDL_PASS)
1677 C_ASSERT(sizeof(XSAVE_FORMAT
) == MAXIMUM_SUPPORTED_EXTENSION
);
1682 #define XSAVE_ALIGN 64
1683 #define MINIMAL_XSTATE_AREA_LENGTH sizeof(XSAVE_AREA)
1685 #if !defined(__midl) && !defined(MIDL_PASS)
1686 C_ASSERT((sizeof(XSAVE_FORMAT
) & (XSAVE_ALIGN
- 1)) == 0);
1687 C_ASSERT((FIELD_OFFSET(XSAVE_AREA
, Header
) & (XSAVE_ALIGN
- 1)) == 0);
1688 C_ASSERT(MINIMAL_XSTATE_AREA_LENGTH
== 512 + 64);
1691 typedef struct _CONTEXT_CHUNK
{
1694 } CONTEXT_CHUNK
, *PCONTEXT_CHUNK
;
1696 typedef struct _CONTEXT_EX
{
1698 CONTEXT_CHUNK Legacy
;
1699 CONTEXT_CHUNK XState
;
1700 } CONTEXT_EX
, *PCONTEXT_EX
;
1702 #define CONTEXT_EX_LENGTH ALIGN_UP_BY(sizeof(CONTEXT_EX), STACK_ALIGN)
1704 #if (NTDDI_VERSION >= NTDDI_VISTA)
1705 extern NTSYSAPI
volatile CCHAR KeNumberProcessors
;
1706 #elif (NTDDI_VERSION >= NTDDI_WINXP)
1707 extern NTSYSAPI CCHAR KeNumberProcessors
;
1709 extern PCCHAR KeNumberProcessors
;
1710 __CREATE_NTOS_DATA_IMPORT_ALIAS(KeNumberProcessors
)
1714 /******************************************************************************
1715 * Memory manager Types *
1716 ******************************************************************************/
1718 #if (NTDDI_VERSION >= NTDDI_WIN2K)
1719 typedef ULONG NODE_REQUIREMENT
;
1720 #define MM_ANY_NODE_OK 0x80000000
1723 #define MM_DONT_ZERO_ALLOCATION 0x00000001
1724 #define MM_ALLOCATE_FROM_LOCAL_NODE_ONLY 0x00000002
1725 #define MM_ALLOCATE_FULLY_REQUIRED 0x00000004
1726 #define MM_ALLOCATE_NO_WAIT 0x00000008
1727 #define MM_ALLOCATE_PREFER_CONTIGUOUS 0x00000010
1728 #define MM_ALLOCATE_REQUIRE_CONTIGUOUS_CHUNKS 0x00000020
1730 #define MDL_MAPPED_TO_SYSTEM_VA 0x0001
1731 #define MDL_PAGES_LOCKED 0x0002
1732 #define MDL_SOURCE_IS_NONPAGED_POOL 0x0004
1733 #define MDL_ALLOCATED_FIXED_SIZE 0x0008
1734 #define MDL_PARTIAL 0x0010
1735 #define MDL_PARTIAL_HAS_BEEN_MAPPED 0x0020
1736 #define MDL_IO_PAGE_READ 0x0040
1737 #define MDL_WRITE_OPERATION 0x0080
1738 #define MDL_PARENT_MAPPED_SYSTEM_VA 0x0100
1739 #define MDL_FREE_EXTRA_PTES 0x0200
1740 #define MDL_DESCRIBES_AWE 0x0400
1741 #define MDL_IO_SPACE 0x0800
1742 #define MDL_NETWORK_HEADER 0x1000
1743 #define MDL_MAPPING_CAN_FAIL 0x2000
1744 #define MDL_ALLOCATED_MUST_SUCCEED 0x4000
1745 #define MDL_INTERNAL 0x8000
1747 #define MDL_MAPPING_FLAGS (MDL_MAPPED_TO_SYSTEM_VA | \
1748 MDL_PAGES_LOCKED | \
1749 MDL_SOURCE_IS_NONPAGED_POOL | \
1750 MDL_PARTIAL_HAS_BEEN_MAPPED | \
1751 MDL_PARENT_MAPPED_SYSTEM_VA | \
1755 #define FLUSH_MULTIPLE_MAXIMUM 32
1757 /* Section access rights */
1758 #define SECTION_QUERY 0x0001
1759 #define SECTION_MAP_WRITE 0x0002
1760 #define SECTION_MAP_READ 0x0004
1761 #define SECTION_MAP_EXECUTE 0x0008
1762 #define SECTION_EXTEND_SIZE 0x0010
1763 #define SECTION_MAP_EXECUTE_EXPLICIT 0x0020
1765 #define SECTION_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED|SECTION_QUERY| \
1766 SECTION_MAP_WRITE | \
1767 SECTION_MAP_READ | \
1768 SECTION_MAP_EXECUTE | \
1769 SECTION_EXTEND_SIZE)
1771 #define SESSION_QUERY_ACCESS 0x0001
1772 #define SESSION_MODIFY_ACCESS 0x0002
1774 #define SESSION_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | \
1775 SESSION_QUERY_ACCESS | \
1776 SESSION_MODIFY_ACCESS)
1778 #define SEGMENT_ALL_ACCESS SECTION_ALL_ACCESS
1780 #define PAGE_NOACCESS 0x01
1781 #define PAGE_READONLY 0x02
1782 #define PAGE_READWRITE 0x04
1783 #define PAGE_WRITECOPY 0x08
1784 #define PAGE_EXECUTE 0x10
1785 #define PAGE_EXECUTE_READ 0x20
1786 #define PAGE_EXECUTE_READWRITE 0x40
1787 #define PAGE_EXECUTE_WRITECOPY 0x80
1788 #define PAGE_GUARD 0x100
1789 #define PAGE_NOCACHE 0x200
1790 #define PAGE_WRITECOMBINE 0x400
1792 #define MEM_COMMIT 0x1000
1793 #define MEM_RESERVE 0x2000
1794 #define MEM_DECOMMIT 0x4000
1795 #define MEM_RELEASE 0x8000
1796 #define MEM_FREE 0x10000
1797 #define MEM_PRIVATE 0x20000
1798 #define MEM_MAPPED 0x40000
1799 #define MEM_RESET 0x80000
1800 #define MEM_TOP_DOWN 0x100000
1801 #define MEM_LARGE_PAGES 0x20000000
1802 #define MEM_4MB_PAGES 0x80000000
1804 #define SEC_RESERVE 0x4000000
1805 #define SEC_COMMIT 0x8000000
1806 #define SEC_LARGE_PAGES 0x80000000
1808 /* Section map options */
1809 typedef enum _SECTION_INHERIT
{
1814 typedef ULONG PFN_COUNT
;
1815 typedef LONG_PTR SPFN_NUMBER
, *PSPFN_NUMBER
;
1816 typedef ULONG_PTR PFN_NUMBER
, *PPFN_NUMBER
;
1818 _Struct_size_bytes_(_Inexpressible_(sizeof(struct _MDL
) +
1819 (ByteOffset
+ ByteCount
+ PAGE_SIZE
-1) / PAGE_SIZE
* sizeof(PFN_NUMBER
)))
1820 typedef struct _MDL
{
1824 struct _EPROCESS
*Process
;
1825 PVOID MappedSystemVa
;
1830 #if (_MSC_VER >= 1600)
1831 typedef _Readable_bytes_(_Inexpressible_(polymorphism
)) MDL
*PMDLX
;
1836 typedef enum _MEMORY_CACHING_TYPE_ORIG
{
1837 MmFrameBufferCached
= 2
1838 } MEMORY_CACHING_TYPE_ORIG
;
1840 typedef enum _MEMORY_CACHING_TYPE
{
1841 MmNonCached
= FALSE
,
1843 MmWriteCombined
= MmFrameBufferCached
,
1844 MmHardwareCoherentCached
,
1845 MmNonCachedUnordered
,
1848 } MEMORY_CACHING_TYPE
;
1850 typedef enum _MM_PAGE_PRIORITY
{
1852 NormalPagePriority
= 16,
1853 HighPagePriority
= 32
1856 typedef enum _MM_SYSTEM_SIZE
{
1863 extern PBOOLEAN Mm64BitPhysicalAddress
;
1864 __CREATE_NTOS_DATA_IMPORT_ALIAS(Mm64BitPhysicalAddress
)
1866 extern NTKERNELAPI PVOID MmBadPointer
;
1869 /******************************************************************************
1871 ******************************************************************************/
1872 #define EX_RUNDOWN_ACTIVE 0x1
1873 #define EX_RUNDOWN_COUNT_SHIFT 0x1
1874 #define EX_RUNDOWN_COUNT_INC (1 << EX_RUNDOWN_COUNT_SHIFT)
1876 typedef struct _FAST_MUTEX
{
1877 volatile LONG Count
;
1882 } FAST_MUTEX
, *PFAST_MUTEX
;
1884 typedef enum _SUITE_TYPE
{
1888 CommunicationServer
,
1890 SmallBusinessRestricted
,
1904 typedef enum _EX_POOL_PRIORITY
{
1906 LowPoolPrioritySpecialPoolOverrun
= 8,
1907 LowPoolPrioritySpecialPoolUnderrun
= 9,
1908 NormalPoolPriority
= 16,
1909 NormalPoolPrioritySpecialPoolOverrun
= 24,
1910 NormalPoolPrioritySpecialPoolUnderrun
= 25,
1911 HighPoolPriority
= 32,
1912 HighPoolPrioritySpecialPoolOverrun
= 40,
1913 HighPoolPrioritySpecialPoolUnderrun
= 41
1916 #if !defined(_WIN64) && (defined(_NTDDK_) || defined(_NTIFS_) || defined(_NDIS_))
1917 #define LOOKASIDE_ALIGN
1919 #define LOOKASIDE_ALIGN DECLSPEC_CACHEALIGN
1922 typedef struct _LOOKASIDE_LIST_EX
*PLOOKASIDE_LIST_EX
;
1924 _IRQL_requires_same_
1925 _Function_class_(ALLOCATE_FUNCTION
)
1927 (NTAPI
*PALLOCATE_FUNCTION
)(
1928 _In_ POOL_TYPE PoolType
,
1929 _In_ SIZE_T NumberOfBytes
,
1932 _IRQL_requires_same_
1933 _Function_class_(ALLOCATE_FUNCTION_EX
)
1935 (NTAPI
*PALLOCATE_FUNCTION_EX
)(
1936 _In_ POOL_TYPE PoolType
,
1937 _In_ SIZE_T NumberOfBytes
,
1939 _Inout_ PLOOKASIDE_LIST_EX Lookaside
);
1941 _IRQL_requires_same_
1942 _Function_class_(FREE_FUNCTION
)
1944 (NTAPI
*PFREE_FUNCTION
)(
1947 _IRQL_requires_same_
1948 _Function_class_(FREE_FUNCTION_EX
)
1950 (NTAPI
*PFREE_FUNCTION_EX
)(
1952 _Inout_ PLOOKASIDE_LIST_EX Lookaside
);
1954 _IRQL_requires_same_
1955 _Function_class_(CALLBACK_FUNCTION
)
1957 (NTAPI CALLBACK_FUNCTION
)(
1958 _In_opt_ PVOID CallbackContext
,
1959 _In_opt_ PVOID Argument1
,
1960 _In_opt_ PVOID Argument2
);
1961 typedef CALLBACK_FUNCTION
*PCALLBACK_FUNCTION
;
1963 #define GENERAL_LOOKASIDE_LAYOUT \
1964 _ANONYMOUS_UNION union { \
1965 SLIST_HEADER ListHead; \
1966 SINGLE_LIST_ENTRY SingleListHead; \
1969 USHORT MaximumDepth; \
1970 ULONG TotalAllocates; \
1971 _ANONYMOUS_UNION union { \
1972 ULONG AllocateMisses; \
1973 ULONG AllocateHits; \
1974 } DUMMYUNIONNAME2; \
1976 _ANONYMOUS_UNION union { \
1979 } DUMMYUNIONNAME3; \
1983 _ANONYMOUS_UNION union { \
1984 PALLOCATE_FUNCTION_EX AllocateEx; \
1985 PALLOCATE_FUNCTION Allocate; \
1986 } DUMMYUNIONNAME4; \
1987 _ANONYMOUS_UNION union { \
1988 PFREE_FUNCTION_EX FreeEx; \
1989 PFREE_FUNCTION Free; \
1990 } DUMMYUNIONNAME5; \
1991 LIST_ENTRY ListEntry; \
1992 ULONG LastTotalAllocates; \
1993 _ANONYMOUS_UNION union { \
1994 ULONG LastAllocateMisses; \
1995 ULONG LastAllocateHits; \
1996 } DUMMYUNIONNAME6; \
1999 typedef struct LOOKASIDE_ALIGN _GENERAL_LOOKASIDE
{
2000 GENERAL_LOOKASIDE_LAYOUT
2001 } GENERAL_LOOKASIDE
, *PGENERAL_LOOKASIDE
;
2003 typedef struct _GENERAL_LOOKASIDE_POOL
{
2004 GENERAL_LOOKASIDE_LAYOUT
2005 } GENERAL_LOOKASIDE_POOL
, *PGENERAL_LOOKASIDE_POOL
;
2007 #define LOOKASIDE_CHECK(f) \
2008 C_ASSERT(FIELD_OFFSET(GENERAL_LOOKASIDE,f) == FIELD_OFFSET(GENERAL_LOOKASIDE_POOL,f))
2010 LOOKASIDE_CHECK(TotalFrees
);
2011 LOOKASIDE_CHECK(Tag
);
2012 LOOKASIDE_CHECK(Future
);
2014 typedef struct LOOKASIDE_ALIGN _PAGED_LOOKASIDE_LIST
{
2015 GENERAL_LOOKASIDE L
;
2016 #if !defined(_AMD64_) && !defined(_IA64_)
2017 FAST_MUTEX Lock__ObsoleteButDoNotDelete
;
2019 } PAGED_LOOKASIDE_LIST
, *PPAGED_LOOKASIDE_LIST
;
2021 typedef struct LOOKASIDE_ALIGN _NPAGED_LOOKASIDE_LIST
{
2022 GENERAL_LOOKASIDE L
;
2023 #if !defined(_AMD64_) && !defined(_IA64_)
2024 KSPIN_LOCK Lock__ObsoleteButDoNotDelete
;
2026 } NPAGED_LOOKASIDE_LIST
, *PNPAGED_LOOKASIDE_LIST
;
2028 #define LOOKASIDE_MINIMUM_BLOCK_SIZE (RTL_SIZEOF_THROUGH_FIELD (SLIST_ENTRY, Next))
2030 typedef struct _LOOKASIDE_LIST_EX
{
2031 GENERAL_LOOKASIDE_POOL L
;
2032 } LOOKASIDE_LIST_EX
;
2034 #if (NTDDI_VERSION >= NTDDI_VISTA)
2036 #define EX_LOOKASIDE_LIST_EX_FLAGS_RAISE_ON_FAIL 0x00000001UL
2037 #define EX_LOOKASIDE_LIST_EX_FLAGS_FAIL_NO_RAISE 0x00000002UL
2039 #define EX_MAXIMUM_LOOKASIDE_DEPTH_BASE 256
2040 #define EX_MAXIMUM_LOOKASIDE_DEPTH_LIMIT 1024
2042 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
2044 typedef struct _EX_RUNDOWN_REF
{
2045 _ANONYMOUS_UNION
union {
2046 volatile ULONG_PTR Count
;
2049 } EX_RUNDOWN_REF
, *PEX_RUNDOWN_REF
;
2051 typedef struct _EX_RUNDOWN_REF_CACHE_AWARE
*PEX_RUNDOWN_REF_CACHE_AWARE
;
2053 typedef enum _WORK_QUEUE_TYPE
{
2056 HyperCriticalWorkQueue
,
2060 _IRQL_requires_same_
2061 _Function_class_(WORKER_THREAD_ROUTINE
)
2063 (NTAPI WORKER_THREAD_ROUTINE
)(
2064 _In_ PVOID Parameter
);
2065 typedef WORKER_THREAD_ROUTINE
*PWORKER_THREAD_ROUTINE
;
2067 typedef struct _WORK_QUEUE_ITEM
{
2069 PWORKER_THREAD_ROUTINE WorkerRoutine
;
2070 volatile PVOID Parameter
;
2071 } WORK_QUEUE_ITEM
, *PWORK_QUEUE_ITEM
;
2073 typedef ULONG_PTR ERESOURCE_THREAD
, *PERESOURCE_THREAD
;
2075 typedef struct _OWNER_ENTRY
{
2076 ERESOURCE_THREAD OwnerThread
;
2077 _ANONYMOUS_UNION
union {
2078 _ANONYMOUS_STRUCT
struct {
2079 ULONG IoPriorityBoosted
:1;
2080 ULONG OwnerReferenced
:1;
2081 ULONG OwnerCount
:30;
2085 } OWNER_ENTRY
, *POWNER_ENTRY
;
2087 typedef struct _ERESOURCE
{
2088 LIST_ENTRY SystemResourcesList
;
2089 POWNER_ENTRY OwnerTable
;
2092 volatile PKSEMAPHORE SharedWaiters
;
2093 volatile PKEVENT ExclusiveWaiters
;
2094 OWNER_ENTRY OwnerEntry
;
2095 ULONG ActiveEntries
;
2096 ULONG ContentionCount
;
2097 ULONG NumberOfSharedWaiters
;
2098 ULONG NumberOfExclusiveWaiters
;
2102 _ANONYMOUS_UNION
union {
2104 ULONG_PTR CreatorBackTraceIndex
;
2106 KSPIN_LOCK SpinLock
;
2107 } ERESOURCE
, *PERESOURCE
;
2109 /* ERESOURCE.Flag */
2110 #define ResourceNeverExclusive 0x0010
2111 #define ResourceReleaseByOtherThread 0x0020
2112 #define ResourceOwnedExclusive 0x0080
2114 #define RESOURCE_HASH_TABLE_SIZE 64
2116 typedef struct _RESOURCE_HASH_ENTRY
{
2117 LIST_ENTRY ListEntry
;
2119 ULONG ContentionCount
;
2121 } RESOURCE_HASH_ENTRY
, *PRESOURCE_HASH_ENTRY
;
2123 typedef struct _RESOURCE_PERFORMANCE_DATA
{
2124 ULONG ActiveResourceCount
;
2125 ULONG TotalResourceCount
;
2126 ULONG ExclusiveAcquire
;
2127 ULONG SharedFirstLevel
;
2128 ULONG SharedSecondLevel
;
2129 ULONG StarveFirstLevel
;
2130 ULONG StarveSecondLevel
;
2131 ULONG WaitForExclusive
;
2132 ULONG OwnerTableExpands
;
2133 ULONG MaximumTableExpand
;
2134 LIST_ENTRY HashTable
[RESOURCE_HASH_TABLE_SIZE
];
2135 } RESOURCE_PERFORMANCE_DATA
, *PRESOURCE_PERFORMANCE_DATA
;
2137 /* Global debug flag */
2139 extern NTKERNELAPI ULONG NtGlobalFlag
;
2140 #define IF_NTOS_DEBUG(FlagName) if (NtGlobalFlag & (FLG_##FlagName))
2142 #define IF_NTOS_DEBUG(FlagName) if(FALSE)
2145 /******************************************************************************
2146 * Security Manager Types *
2147 ******************************************************************************/
2150 typedef PVOID PSECURITY_DESCRIPTOR
;
2151 typedef ULONG SECURITY_INFORMATION
, *PSECURITY_INFORMATION
;
2152 typedef ULONG ACCESS_MASK
, *PACCESS_MASK
;
2153 typedef PVOID PACCESS_TOKEN
;
2156 #define DELETE 0x00010000L
2157 #define READ_CONTROL 0x00020000L
2158 #define WRITE_DAC 0x00040000L
2159 #define WRITE_OWNER 0x00080000L
2160 #define SYNCHRONIZE 0x00100000L
2161 #define STANDARD_RIGHTS_REQUIRED 0x000F0000L
2162 #define STANDARD_RIGHTS_READ READ_CONTROL
2163 #define STANDARD_RIGHTS_WRITE READ_CONTROL
2164 #define STANDARD_RIGHTS_EXECUTE READ_CONTROL
2165 #define STANDARD_RIGHTS_ALL 0x001F0000L
2166 #define SPECIFIC_RIGHTS_ALL 0x0000FFFFL
2167 #define ACCESS_SYSTEM_SECURITY 0x01000000L
2168 #define MAXIMUM_ALLOWED 0x02000000L
2169 #define GENERIC_READ 0x80000000L
2170 #define GENERIC_WRITE 0x40000000L
2171 #define GENERIC_EXECUTE 0x20000000L
2172 #define GENERIC_ALL 0x10000000L
2174 typedef struct _GENERIC_MAPPING
{
2175 ACCESS_MASK GenericRead
;
2176 ACCESS_MASK GenericWrite
;
2177 ACCESS_MASK GenericExecute
;
2178 ACCESS_MASK GenericAll
;
2179 } GENERIC_MAPPING
, *PGENERIC_MAPPING
;
2181 #define ACL_REVISION 2
2182 #define ACL_REVISION_DS 4
2184 #define ACL_REVISION1 1
2185 #define ACL_REVISION2 2
2186 #define ACL_REVISION3 3
2187 #define ACL_REVISION4 4
2188 #define MIN_ACL_REVISION ACL_REVISION2
2189 #define MAX_ACL_REVISION ACL_REVISION4
2191 typedef struct _ACL
{
2199 /* Current security descriptor revision value */
2200 #define SECURITY_DESCRIPTOR_REVISION (1)
2201 #define SECURITY_DESCRIPTOR_REVISION1 (1)
2203 /* Privilege attributes */
2204 #define SE_PRIVILEGE_ENABLED_BY_DEFAULT (0x00000001L)
2205 #define SE_PRIVILEGE_ENABLED (0x00000002L)
2206 #define SE_PRIVILEGE_REMOVED (0X00000004L)
2207 #define SE_PRIVILEGE_USED_FOR_ACCESS (0x80000000L)
2209 #define SE_PRIVILEGE_VALID_ATTRIBUTES (SE_PRIVILEGE_ENABLED_BY_DEFAULT | \
2210 SE_PRIVILEGE_ENABLED | \
2211 SE_PRIVILEGE_REMOVED | \
2212 SE_PRIVILEGE_USED_FOR_ACCESS)
2214 #include <pshpack4.h>
2215 typedef struct _LUID_AND_ATTRIBUTES
{
2218 } LUID_AND_ATTRIBUTES
, *PLUID_AND_ATTRIBUTES
;
2219 #include <poppack.h>
2221 typedef LUID_AND_ATTRIBUTES LUID_AND_ATTRIBUTES_ARRAY
[ANYSIZE_ARRAY
];
2222 typedef LUID_AND_ATTRIBUTES_ARRAY
*PLUID_AND_ATTRIBUTES_ARRAY
;
2224 /* Privilege sets */
2225 #define PRIVILEGE_SET_ALL_NECESSARY (1)
2227 typedef struct _PRIVILEGE_SET
{
2228 ULONG PrivilegeCount
;
2230 LUID_AND_ATTRIBUTES Privilege
[ANYSIZE_ARRAY
];
2231 } PRIVILEGE_SET
,*PPRIVILEGE_SET
;
2233 typedef enum _SECURITY_IMPERSONATION_LEVEL
{
2235 SecurityIdentification
,
2236 SecurityImpersonation
,
2238 } SECURITY_IMPERSONATION_LEVEL
, * PSECURITY_IMPERSONATION_LEVEL
;
2240 #define SECURITY_MAX_IMPERSONATION_LEVEL SecurityDelegation
2241 #define SECURITY_MIN_IMPERSONATION_LEVEL SecurityAnonymous
2242 #define DEFAULT_IMPERSONATION_LEVEL SecurityImpersonation
2243 #define VALID_IMPERSONATION_LEVEL(Level) (((Level) >= SECURITY_MIN_IMPERSONATION_LEVEL) && ((Level) <= SECURITY_MAX_IMPERSONATION_LEVEL))
2245 #define SECURITY_DYNAMIC_TRACKING (TRUE)
2246 #define SECURITY_STATIC_TRACKING (FALSE)
2248 typedef BOOLEAN SECURITY_CONTEXT_TRACKING_MODE
, *PSECURITY_CONTEXT_TRACKING_MODE
;
2250 typedef struct _SECURITY_QUALITY_OF_SERVICE
{
2252 SECURITY_IMPERSONATION_LEVEL ImpersonationLevel
;
2253 SECURITY_CONTEXT_TRACKING_MODE ContextTrackingMode
;
2254 BOOLEAN EffectiveOnly
;
2255 } SECURITY_QUALITY_OF_SERVICE
, *PSECURITY_QUALITY_OF_SERVICE
;
2257 typedef struct _SE_IMPERSONATION_STATE
{
2258 PACCESS_TOKEN Token
;
2260 BOOLEAN EffectiveOnly
;
2261 SECURITY_IMPERSONATION_LEVEL Level
;
2262 } SE_IMPERSONATION_STATE
, *PSE_IMPERSONATION_STATE
;
2264 #define OWNER_SECURITY_INFORMATION (0x00000001L)
2265 #define GROUP_SECURITY_INFORMATION (0x00000002L)
2266 #define DACL_SECURITY_INFORMATION (0x00000004L)
2267 #define SACL_SECURITY_INFORMATION (0x00000008L)
2268 #define LABEL_SECURITY_INFORMATION (0x00000010L)
2270 #define PROTECTED_DACL_SECURITY_INFORMATION (0x80000000L)
2271 #define PROTECTED_SACL_SECURITY_INFORMATION (0x40000000L)
2272 #define UNPROTECTED_DACL_SECURITY_INFORMATION (0x20000000L)
2273 #define UNPROTECTED_SACL_SECURITY_INFORMATION (0x10000000L)
2275 typedef enum _SECURITY_OPERATION_CODE
{
2276 SetSecurityDescriptor
,
2277 QuerySecurityDescriptor
,
2278 DeleteSecurityDescriptor
,
2279 AssignSecurityDescriptor
2280 } SECURITY_OPERATION_CODE
, *PSECURITY_OPERATION_CODE
;
2282 #define INITIAL_PRIVILEGE_COUNT 3
2284 typedef struct _INITIAL_PRIVILEGE_SET
{
2285 ULONG PrivilegeCount
;
2287 LUID_AND_ATTRIBUTES Privilege
[INITIAL_PRIVILEGE_COUNT
];
2288 } INITIAL_PRIVILEGE_SET
, * PINITIAL_PRIVILEGE_SET
;
2290 #define SE_MIN_WELL_KNOWN_PRIVILEGE 2
2291 #define SE_CREATE_TOKEN_PRIVILEGE 2
2292 #define SE_ASSIGNPRIMARYTOKEN_PRIVILEGE 3
2293 #define SE_LOCK_MEMORY_PRIVILEGE 4
2294 #define SE_INCREASE_QUOTA_PRIVILEGE 5
2295 #define SE_MACHINE_ACCOUNT_PRIVILEGE 6
2296 #define SE_TCB_PRIVILEGE 7
2297 #define SE_SECURITY_PRIVILEGE 8
2298 #define SE_TAKE_OWNERSHIP_PRIVILEGE 9
2299 #define SE_LOAD_DRIVER_PRIVILEGE 10
2300 #define SE_SYSTEM_PROFILE_PRIVILEGE 11
2301 #define SE_SYSTEMTIME_PRIVILEGE 12
2302 #define SE_PROF_SINGLE_PROCESS_PRIVILEGE 13
2303 #define SE_INC_BASE_PRIORITY_PRIVILEGE 14
2304 #define SE_CREATE_PAGEFILE_PRIVILEGE 15
2305 #define SE_CREATE_PERMANENT_PRIVILEGE 16
2306 #define SE_BACKUP_PRIVILEGE 17
2307 #define SE_RESTORE_PRIVILEGE 18
2308 #define SE_SHUTDOWN_PRIVILEGE 19
2309 #define SE_DEBUG_PRIVILEGE 20
2310 #define SE_AUDIT_PRIVILEGE 21
2311 #define SE_SYSTEM_ENVIRONMENT_PRIVILEGE 22
2312 #define SE_CHANGE_NOTIFY_PRIVILEGE 23
2313 #define SE_REMOTE_SHUTDOWN_PRIVILEGE 24
2314 #define SE_UNDOCK_PRIVILEGE 25
2315 #define SE_SYNC_AGENT_PRIVILEGE 26
2316 #define SE_ENABLE_DELEGATION_PRIVILEGE 27
2317 #define SE_MANAGE_VOLUME_PRIVILEGE 28
2318 #define SE_IMPERSONATE_PRIVILEGE 29
2319 #define SE_CREATE_GLOBAL_PRIVILEGE 30
2320 #define SE_TRUSTED_CREDMAN_ACCESS_PRIVILEGE 31
2321 #define SE_RELABEL_PRIVILEGE 32
2322 #define SE_INC_WORKING_SET_PRIVILEGE 33
2323 #define SE_TIME_ZONE_PRIVILEGE 34
2324 #define SE_CREATE_SYMBOLIC_LINK_PRIVILEGE 35
2325 #define SE_MAX_WELL_KNOWN_PRIVILEGE SE_CREATE_SYMBOLIC_LINK_PRIVILEGE
2327 typedef struct _SECURITY_SUBJECT_CONTEXT
{
2328 PACCESS_TOKEN ClientToken
;
2329 SECURITY_IMPERSONATION_LEVEL ImpersonationLevel
;
2330 PACCESS_TOKEN PrimaryToken
;
2331 PVOID ProcessAuditId
;
2332 } SECURITY_SUBJECT_CONTEXT
, *PSECURITY_SUBJECT_CONTEXT
;
2334 typedef struct _ACCESS_STATE
{
2336 BOOLEAN SecurityEvaluated
;
2337 BOOLEAN GenerateAudit
;
2338 BOOLEAN GenerateOnClose
;
2339 BOOLEAN PrivilegesAllocated
;
2341 ACCESS_MASK RemainingDesiredAccess
;
2342 ACCESS_MASK PreviouslyGrantedAccess
;
2343 ACCESS_MASK OriginalDesiredAccess
;
2344 SECURITY_SUBJECT_CONTEXT SubjectSecurityContext
;
2345 PSECURITY_DESCRIPTOR SecurityDescriptor
;
2348 INITIAL_PRIVILEGE_SET InitialPrivilegeSet
;
2349 PRIVILEGE_SET PrivilegeSet
;
2351 BOOLEAN AuditPrivileges
;
2352 UNICODE_STRING ObjectName
;
2353 UNICODE_STRING ObjectTypeName
;
2354 } ACCESS_STATE
, *PACCESS_STATE
;
2357 (NTAPI
*PNTFS_DEREF_EXPORTED_SECURITY_DESCRIPTOR
)(
2359 _In_ PSECURITY_DESCRIPTOR SecurityDescriptor
);
2363 #ifndef _NTLSA_AUDIT_
2364 #define _NTLSA_AUDIT_
2366 #define SE_MAX_AUDIT_PARAMETERS 32
2367 #define SE_MAX_GENERIC_AUDIT_PARAMETERS 28
2369 #define SE_ADT_OBJECT_ONLY 0x1
2371 #define SE_ADT_PARAMETERS_SELF_RELATIVE 0x00000001
2372 #define SE_ADT_PARAMETERS_SEND_TO_LSA 0x00000002
2373 #define SE_ADT_PARAMETER_EXTENSIBLE_AUDIT 0x00000004
2374 #define SE_ADT_PARAMETER_GENERIC_AUDIT 0x00000008
2375 #define SE_ADT_PARAMETER_WRITE_SYNCHRONOUS 0x00000010
2377 #define LSAP_SE_ADT_PARAMETER_ARRAY_TRUE_SIZE(Parameters) \
2378 ( sizeof(SE_ADT_PARAMETER_ARRAY) - sizeof(SE_ADT_PARAMETER_ARRAY_ENTRY) * \
2379 (SE_MAX_AUDIT_PARAMETERS - Parameters->ParameterCount) )
2381 typedef enum _SE_ADT_PARAMETER_TYPE
{
2382 SeAdtParmTypeNone
= 0,
2383 SeAdtParmTypeString
,
2384 SeAdtParmTypeFileSpec
,
2387 SeAdtParmTypeLogonId
,
2388 SeAdtParmTypeNoLogonId
,
2389 SeAdtParmTypeAccessMask
,
2391 SeAdtParmTypeObjectTypes
,
2392 SeAdtParmTypeHexUlong
,
2397 SeAdtParmTypeHexInt64
,
2398 SeAdtParmTypeStringList
,
2399 SeAdtParmTypeSidList
,
2400 SeAdtParmTypeDuration
,
2401 SeAdtParmTypeUserAccountControl
,
2403 SeAdtParmTypeMessage
,
2404 SeAdtParmTypeDateTime
,
2405 SeAdtParmTypeSockAddr
,
2407 SeAdtParmTypeLogonHours
,
2408 SeAdtParmTypeLogonIdNoSid
,
2409 SeAdtParmTypeUlongNoConv
,
2410 SeAdtParmTypeSockAddrNoPort
,
2411 SeAdtParmTypeAccessReason
2412 } SE_ADT_PARAMETER_TYPE
, *PSE_ADT_PARAMETER_TYPE
;
2414 typedef struct _SE_ADT_OBJECT_TYPE
{
2418 ACCESS_MASK AccessMask
;
2419 } SE_ADT_OBJECT_TYPE
, *PSE_ADT_OBJECT_TYPE
;
2421 typedef struct _SE_ADT_PARAMETER_ARRAY_ENTRY
{
2422 SE_ADT_PARAMETER_TYPE Type
;
2426 } SE_ADT_PARAMETER_ARRAY_ENTRY
, *PSE_ADT_PARAMETER_ARRAY_ENTRY
;
2428 typedef struct _SE_ADT_ACCESS_REASON
{
2429 ACCESS_MASK AccessMask
;
2430 ULONG AccessReasons
[32];
2431 ULONG ObjectTypeIndex
;
2432 ULONG AccessGranted
;
2433 PSECURITY_DESCRIPTOR SecurityDescriptor
;
2434 } SE_ADT_ACCESS_REASON
, *PSE_ADT_ACCESS_REASON
;
2436 typedef struct _SE_ADT_PARAMETER_ARRAY
{
2439 ULONG ParameterCount
;
2441 USHORT FlatSubCategoryId
;
2444 SE_ADT_PARAMETER_ARRAY_ENTRY Parameters
[ SE_MAX_AUDIT_PARAMETERS
];
2445 } SE_ADT_PARAMETER_ARRAY
, *PSE_ADT_PARAMETER_ARRAY
;
2447 #endif /* !_NTLSA_AUDIT_ */
2448 #endif /* !_NTLSA_IFS_ */
2449 /******************************************************************************
2450 * Power Management Support Types *
2451 ******************************************************************************/
2456 #define PO_CB_SYSTEM_POWER_POLICY 0
2457 #define PO_CB_AC_STATUS 1
2458 #define PO_CB_BUTTON_COLLISION 2
2459 #define PO_CB_SYSTEM_STATE_LOCK 3
2460 #define PO_CB_LID_SWITCH_STATE 4
2461 #define PO_CB_PROCESSOR_POWER_POLICY 5
2463 /* Power States/Levels */
2464 typedef enum _SYSTEM_POWER_STATE
{
2465 PowerSystemUnspecified
= 0,
2467 PowerSystemSleeping1
,
2468 PowerSystemSleeping2
,
2469 PowerSystemSleeping3
,
2470 PowerSystemHibernate
,
2471 PowerSystemShutdown
,
2473 } SYSTEM_POWER_STATE
, *PSYSTEM_POWER_STATE
;
2475 #define POWER_SYSTEM_MAXIMUM PowerSystemMaximum
2477 typedef enum _POWER_INFORMATION_LEVEL
{
2478 SystemPowerPolicyAc
,
2479 SystemPowerPolicyDc
,
2480 VerifySystemPolicyAc
,
2481 VerifySystemPolicyDc
,
2482 SystemPowerCapabilities
,
2484 SystemPowerStateHandler
,
2485 ProcessorStateHandler
,
2486 SystemPowerPolicyCurrent
,
2487 AdministratorPowerPolicy
,
2488 SystemReserveHiberFile
,
2489 ProcessorInformation
,
2490 SystemPowerInformation
,
2491 ProcessorStateHandler2
,
2494 SystemExecutionState
,
2495 SystemPowerStateNotifyHandler
,
2496 ProcessorPowerPolicyAc
,
2497 ProcessorPowerPolicyDc
,
2498 VerifyProcessorPowerPolicyAc
,
2499 VerifyProcessorPowerPolicyDc
,
2500 ProcessorPowerPolicyCurrent
,
2501 SystemPowerStateLogging
,
2502 SystemPowerLoggingEntry
,
2503 SetPowerSettingValue
,
2504 NotifyUserPowerSetting
,
2505 PowerInformationLevelUnused0
,
2506 PowerInformationLevelUnused1
,
2508 TraceApplicationPowerMessage
,
2509 TraceApplicationPowerMessageEnd
,
2510 ProcessorPerfStates
,
2511 ProcessorIdleStates
,
2514 SystemHiberFileInformation
,
2515 TraceServicePowerMessage
,
2517 PowerShutdownNotification
,
2518 MonitorCapabilities
,
2520 SessionDisplayState
,
2523 GetPowerRequestList
,
2524 ProcessorInformationEx
,
2525 NotifyUserModeLegacyPowerEvent
,
2527 ProcessorIdleDomains
,
2529 SystemHiberFileSize
,
2530 PowerInformationLevelMaximum
2531 } POWER_INFORMATION_LEVEL
;
2534 PowerActionNone
= 0,
2535 PowerActionReserved
,
2537 PowerActionHibernate
,
2538 PowerActionShutdown
,
2539 PowerActionShutdownReset
,
2540 PowerActionShutdownOff
,
2541 PowerActionWarmEject
2542 } POWER_ACTION
, *PPOWER_ACTION
;
2544 typedef enum _DEVICE_POWER_STATE
{
2545 PowerDeviceUnspecified
= 0,
2551 } DEVICE_POWER_STATE
, *PDEVICE_POWER_STATE
;
2553 typedef enum _MONITOR_DISPLAY_STATE
{
2554 PowerMonitorOff
= 0,
2557 } MONITOR_DISPLAY_STATE
, *PMONITOR_DISPLAY_STATE
;
2559 typedef union _POWER_STATE
{
2560 SYSTEM_POWER_STATE SystemState
;
2561 DEVICE_POWER_STATE DeviceState
;
2562 } POWER_STATE
, *PPOWER_STATE
;
2564 typedef enum _POWER_STATE_TYPE
{
2565 SystemPowerState
= 0,
2567 } POWER_STATE_TYPE
, *PPOWER_STATE_TYPE
;
2569 #if (NTDDI_VERSION >= NTDDI_VISTA)
2570 typedef struct _SYSTEM_POWER_STATE_CONTEXT
{
2571 _ANONYMOUS_UNION
union {
2572 _ANONYMOUS_STRUCT
struct {
2574 ULONG TargetSystemState
:4;
2575 ULONG EffectiveSystemState
:4;
2576 ULONG CurrentSystemState
:4;
2577 ULONG IgnoreHibernationPath
:1;
2578 ULONG PseudoTransition
:1;
2581 ULONG ContextAsUlong
;
2583 } SYSTEM_POWER_STATE_CONTEXT
, *PSYSTEM_POWER_STATE_CONTEXT
;
2586 #if (NTDDI_VERSION >= NTDDI_WIN7)
2587 typedef struct _COUNTED_REASON_CONTEXT
{
2590 _ANONYMOUS_UNION
union {
2591 _ANONYMOUS_STRUCT
struct {
2592 UNICODE_STRING ResourceFileName
;
2593 USHORT ResourceReasonId
;
2595 PUNICODE_STRING ReasonStrings
;
2597 UNICODE_STRING SimpleString
;
2599 } COUNTED_REASON_CONTEXT
, *PCOUNTED_REASON_CONTEXT
;
2602 #define IOCTL_QUERY_DEVICE_POWER_STATE \
2603 CTL_CODE(FILE_DEVICE_BATTERY, 0x0, METHOD_BUFFERED, FILE_READ_ACCESS)
2605 #define IOCTL_SET_DEVICE_WAKE \
2606 CTL_CODE(FILE_DEVICE_BATTERY, 0x1, METHOD_BUFFERED, FILE_WRITE_ACCESS)
2608 #define IOCTL_CANCEL_DEVICE_WAKE \
2609 CTL_CODE(FILE_DEVICE_BATTERY, 0x2, METHOD_BUFFERED, FILE_WRITE_ACCESS)
2611 #define ES_SYSTEM_REQUIRED 0x00000001
2612 #define ES_DISPLAY_REQUIRED 0x00000002
2613 #define ES_USER_PRESENT 0x00000004
2614 #define ES_CONTINUOUS 0x80000000
2616 typedef ULONG EXECUTION_STATE
, *PEXECUTION_STATE
;
2623 #if (_WIN32_WINNT >= _WIN32_WINNT_WIN7)
2624 #define DIAGNOSTIC_REASON_VERSION 0
2625 #define DIAGNOSTIC_REASON_SIMPLE_STRING 0x00000001
2626 #define DIAGNOSTIC_REASON_DETAILED_STRING 0x00000002
2627 #define DIAGNOSTIC_REASON_NOT_SPECIFIED 0x80000000
2628 #define DIAGNOSTIC_REASON_INVALID_FLAGS (~0x80000003)
2631 #define POWER_REQUEST_CONTEXT_VERSION 0
2632 #define POWER_REQUEST_CONTEXT_SIMPLE_STRING 0x00000001
2633 #define POWER_REQUEST_CONTEXT_DETAILED_STRING 0x00000002
2635 #define PowerRequestMaximum 3
2637 typedef enum _POWER_REQUEST_TYPE
{
2638 PowerRequestDisplayRequired
,
2639 PowerRequestSystemRequired
,
2640 PowerRequestAwayModeRequired
2641 } POWER_REQUEST_TYPE
, *PPOWER_REQUEST_TYPE
;
2643 #if (NTDDI_VERSION >= NTDDI_WINXP)
2645 #define PDCAP_D0_SUPPORTED 0x00000001
2646 #define PDCAP_D1_SUPPORTED 0x00000002
2647 #define PDCAP_D2_SUPPORTED 0x00000004
2648 #define PDCAP_D3_SUPPORTED 0x00000008
2649 #define PDCAP_WAKE_FROM_D0_SUPPORTED 0x00000010
2650 #define PDCAP_WAKE_FROM_D1_SUPPORTED 0x00000020
2651 #define PDCAP_WAKE_FROM_D2_SUPPORTED 0x00000040
2652 #define PDCAP_WAKE_FROM_D3_SUPPORTED 0x00000080
2653 #define PDCAP_WARM_EJECT_SUPPORTED 0x00000100
2655 typedef struct CM_Power_Data_s
{
2657 DEVICE_POWER_STATE PD_MostRecentPowerState
;
2658 ULONG PD_Capabilities
;
2662 DEVICE_POWER_STATE PD_PowerStateMapping
[PowerSystemMaximum
];
2663 SYSTEM_POWER_STATE PD_DeepestSystemWake
;
2664 } CM_POWER_DATA
, *PCM_POWER_DATA
;
2666 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) */
2668 typedef enum _SYSTEM_POWER_CONDITION
{
2673 } SYSTEM_POWER_CONDITION
;
2675 typedef struct _SET_POWER_SETTING_VALUE
{
2678 SYSTEM_POWER_CONDITION PowerCondition
;
2680 UCHAR Data
[ANYSIZE_ARRAY
];
2681 } SET_POWER_SETTING_VALUE
, *PSET_POWER_SETTING_VALUE
;
2683 #define POWER_SETTING_VALUE_VERSION (0x1)
2685 typedef struct _NOTIFY_USER_POWER_SETTING
{
2687 } NOTIFY_USER_POWER_SETTING
, *PNOTIFY_USER_POWER_SETTING
;
2689 typedef struct _APPLICATIONLAUNCH_SETTING_VALUE
{
2690 LARGE_INTEGER ActivationTime
;
2692 ULONG ButtonInstanceID
;
2693 } APPLICATIONLAUNCH_SETTING_VALUE
, *PAPPLICATIONLAUNCH_SETTING_VALUE
;
2695 typedef enum _POWER_PLATFORM_ROLE
{
2696 PlatformRoleUnspecified
= 0,
2697 PlatformRoleDesktop
,
2699 PlatformRoleWorkstation
,
2700 PlatformRoleEnterpriseServer
,
2701 PlatformRoleSOHOServer
,
2702 PlatformRoleAppliancePC
,
2703 PlatformRolePerformanceServer
,
2705 } POWER_PLATFORM_ROLE
;
2707 #if (NTDDI_VERSION >= NTDDI_WINXP) || !defined(_BATCLASS_)
2711 } BATTERY_REPORTING_SCALE
, *PBATTERY_REPORTING_SCALE
;
2712 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) || !defined(_BATCLASS_) */
2714 #endif /* !_PO_DDK_ */
2716 #define CORE_PARKING_POLICY_CHANGE_IDEAL 0
2717 #define CORE_PARKING_POLICY_CHANGE_SINGLE 1
2718 #define CORE_PARKING_POLICY_CHANGE_ROCKET 2
2719 #define CORE_PARKING_POLICY_CHANGE_MAX CORE_PARKING_POLICY_CHANGE_ROCKET
2721 DEFINE_GUID(GUID_MAX_POWER_SAVINGS
, 0xA1841308, 0x3541, 0x4FAB, 0xBC, 0x81, 0xF7, 0x15, 0x56, 0xF2, 0x0B, 0x4A);
2722 DEFINE_GUID(GUID_MIN_POWER_SAVINGS
, 0x8C5E7FDA, 0xE8BF, 0x4A96, 0x9A, 0x85, 0xA6, 0xE2, 0x3A, 0x8C, 0x63, 0x5C);
2723 DEFINE_GUID(GUID_TYPICAL_POWER_SAVINGS
, 0x381B4222, 0xF694, 0x41F0, 0x96, 0x85, 0xFF, 0x5B, 0xB2, 0x60, 0xDF, 0x2E);
2724 DEFINE_GUID(NO_SUBGROUP_GUID
, 0xFEA3413E, 0x7E05, 0x4911, 0x9A, 0x71, 0x70, 0x03, 0x31, 0xF1, 0xC2, 0x94);
2725 DEFINE_GUID(ALL_POWERSCHEMES_GUID
, 0x68A1E95E, 0x13EA, 0x41E1, 0x80, 0x11, 0x0C, 0x49, 0x6C, 0xA4, 0x90, 0xB0);
2726 DEFINE_GUID(GUID_POWERSCHEME_PERSONALITY
, 0x245D8541, 0x3943, 0x4422, 0xB0, 0x25, 0x13, 0xA7, 0x84, 0xF6, 0x79, 0xB7);
2727 DEFINE_GUID(GUID_ACTIVE_POWERSCHEME
, 0x31F9F286, 0x5084, 0x42FE, 0xB7, 0x20, 0x2B, 0x02, 0x64, 0x99, 0x37, 0x63);
2728 DEFINE_GUID(GUID_VIDEO_SUBGROUP
, 0x7516B95F, 0xF776, 0x4464, 0x8C, 0x53, 0x06, 0x16, 0x7F, 0x40, 0xCC, 0x99);
2729 DEFINE_GUID(GUID_VIDEO_POWERDOWN_TIMEOUT
, 0x3C0BC021, 0xC8A8, 0x4E07, 0xA9, 0x73, 0x6B, 0x14, 0xCB, 0xCB, 0x2B, 0x7E);
2730 DEFINE_GUID(GUID_VIDEO_ANNOYANCE_TIMEOUT
, 0x82DBCF2D, 0xCD67, 0x40C5, 0xBF, 0xDC, 0x9F, 0x1A, 0x5C, 0xCD, 0x46, 0x63);
2731 DEFINE_GUID(GUID_VIDEO_ADAPTIVE_PERCENT_INCREASE
, 0xEED904DF, 0xB142, 0x4183, 0xB1, 0x0B, 0x5A, 0x11, 0x97, 0xA3, 0x78, 0x64);
2732 DEFINE_GUID(GUID_VIDEO_DIM_TIMEOUT
, 0x17aaa29b, 0x8b43, 0x4b94, 0xaa, 0xfe, 0x35, 0xf6, 0x4d, 0xaa, 0xf1, 0xee);
2733 DEFINE_GUID(GUID_VIDEO_ADAPTIVE_POWERDOWN
, 0x90959D22, 0xD6A1, 0x49B9, 0xAF, 0x93, 0xBC, 0xE8, 0x85, 0xAD, 0x33, 0x5B);
2734 DEFINE_GUID(GUID_MONITOR_POWER_ON
, 0x02731015, 0x4510, 0x4526, 0x99, 0xE6, 0xE5, 0xA1, 0x7E, 0xBD, 0x1A, 0xEA);
2735 DEFINE_GUID(GUID_DEVICE_POWER_POLICY_VIDEO_BRIGHTNESS
, 0xaded5e82L
, 0xb909, 0x4619, 0x99, 0x49, 0xf5, 0xd7, 0x1d, 0xac, 0x0b, 0xcb);
2736 DEFINE_GUID(GUID_DEVICE_POWER_POLICY_VIDEO_DIM_BRIGHTNESS
, 0xf1fbfde2, 0xa960, 0x4165, 0x9f, 0x88, 0x50, 0x66, 0x79, 0x11, 0xce, 0x96);
2737 DEFINE_GUID(GUID_VIDEO_CURRENT_MONITOR_BRIGHTNESS
, 0x8ffee2c6, 0x2d01, 0x46be, 0xad, 0xb9, 0x39, 0x8a, 0xdd, 0xc5, 0xb4, 0xff);
2738 DEFINE_GUID(GUID_VIDEO_ADAPTIVE_DISPLAY_BRIGHTNESS
, 0xFBD9AA66, 0x9553, 0x4097, 0xBA, 0x44, 0xED, 0x6E, 0x9D, 0x65, 0xEA, 0xB8);
2739 DEFINE_GUID(GUID_SESSION_DISPLAY_STATE
, 0x73A5E93A, 0x5BB1, 0x4F93, 0x89, 0x5B, 0xDB, 0xD0, 0xDA, 0x85, 0x59, 0x67);
2740 DEFINE_GUID(GUID_CONSOLE_DISPLAY_STATE
, 0x6fe69556, 0x704a, 0x47a0, 0x8f, 0x24, 0xc2, 0x8d, 0x93, 0x6f, 0xda, 0x47);
2741 DEFINE_GUID(GUID_ALLOW_DISPLAY_REQUIRED
, 0xA9CEB8DA, 0xCD46, 0x44FB, 0xA9, 0x8B, 0x02, 0xAF, 0x69, 0xDE, 0x46, 0x23);
2742 DEFINE_GUID(GUID_DISK_SUBGROUP
, 0x0012EE47, 0x9041, 0x4B5D, 0x9B, 0x77, 0x53, 0x5F, 0xBA, 0x8B, 0x14, 0x42);
2743 DEFINE_GUID(GUID_DISK_POWERDOWN_TIMEOUT
, 0x6738E2C4, 0xE8A5, 0x4A42, 0xB1, 0x6A, 0xE0, 0x40, 0xE7, 0x69, 0x75, 0x6E);
2744 DEFINE_GUID(GUID_DISK_BURST_IGNORE_THRESHOLD
, 0x80e3c60e, 0xbb94, 0x4ad8, 0xbb, 0xe0, 0x0d, 0x31, 0x95, 0xef, 0xc6, 0x63);
2745 DEFINE_GUID(GUID_DISK_ADAPTIVE_POWERDOWN
, 0x396A32E1, 0x499A, 0x40B2, 0x91, 0x24, 0xA9, 0x6A, 0xFE, 0x70, 0x76, 0x67);
2746 DEFINE_GUID(GUID_SLEEP_SUBGROUP
, 0x238C9FA8, 0x0AAD, 0x41ED, 0x83, 0xF4, 0x97, 0xBE, 0x24, 0x2C, 0x8F, 0x20);
2747 DEFINE_GUID(GUID_SLEEP_IDLE_THRESHOLD
, 0x81cd32e0, 0x7833, 0x44f3, 0x87, 0x37, 0x70, 0x81, 0xf3, 0x8d, 0x1f, 0x70);
2748 DEFINE_GUID(GUID_STANDBY_TIMEOUT
, 0x29F6C1DB, 0x86DA, 0x48C5, 0x9F, 0xDB, 0xF2, 0xB6, 0x7B, 0x1F, 0x44, 0xDA);
2749 DEFINE_GUID(GUID_UNATTEND_SLEEP_TIMEOUT
, 0x7bc4a2f9, 0xd8fc, 0x4469, 0xb0, 0x7b, 0x33, 0xeb, 0x78, 0x5a, 0xac, 0xa0);
2750 DEFINE_GUID(GUID_HIBERNATE_TIMEOUT
, 0x9D7815A6, 0x7EE4, 0x497E, 0x88, 0x88, 0x51, 0x5A, 0x05, 0xF0, 0x23, 0x64);
2751 DEFINE_GUID(GUID_HIBERNATE_FASTS4_POLICY
, 0x94AC6D29, 0x73CE, 0x41A6, 0x80, 0x9F, 0x63, 0x63, 0xBA, 0x21, 0xB4, 0x7E);
2752 DEFINE_GUID(GUID_CRITICAL_POWER_TRANSITION
, 0xB7A27025, 0xE569, 0x46c2, 0xA5, 0x04, 0x2B, 0x96, 0xCA, 0xD2, 0x25, 0xA1);
2753 DEFINE_GUID(GUID_SYSTEM_AWAYMODE
, 0x98A7F580, 0x01F7, 0x48AA, 0x9C, 0x0F, 0x44, 0x35, 0x2C, 0x29, 0xE5, 0xC0);
2754 DEFINE_GUID(GUID_ALLOW_AWAYMODE
, 0x25dfa149, 0x5dd1, 0x4736, 0xb5, 0xab, 0xe8, 0xa3, 0x7b, 0x5b, 0x81, 0x87);
2755 DEFINE_GUID(GUID_ALLOW_STANDBY_STATES
, 0xabfc2519, 0x3608, 0x4c2a, 0x94, 0xea, 0x17, 0x1b, 0x0e, 0xd5, 0x46, 0xab);
2756 DEFINE_GUID(GUID_ALLOW_RTC_WAKE
, 0xBD3B718A, 0x0680, 0x4D9D, 0x8A, 0xB2, 0xE1, 0xD2, 0xB4, 0xAC, 0x80, 0x6D);
2757 DEFINE_GUID(GUID_ALLOW_SYSTEM_REQUIRED
, 0xA4B195F5, 0x8225, 0x47D8, 0x80, 0x12, 0x9D, 0x41, 0x36, 0x97, 0x86, 0xE2);
2758 DEFINE_GUID(GUID_SYSTEM_BUTTON_SUBGROUP
, 0x4F971E89, 0xEEBD, 0x4455, 0xA8, 0xDE, 0x9E, 0x59, 0x04, 0x0E, 0x73, 0x47);
2759 DEFINE_GUID(GUID_POWERBUTTON_ACTION
, 0x7648EFA3, 0xDD9C, 0x4E3E, 0xB5, 0x66, 0x50, 0xF9, 0x29, 0x38, 0x62, 0x80);
2760 DEFINE_GUID(GUID_POWERBUTTON_ACTION_FLAGS
, 0x857E7FAC, 0x034B, 0x4704, 0xAB, 0xB1, 0xBC, 0xA5, 0x4A, 0xA3, 0x14, 0x78);
2761 DEFINE_GUID(GUID_SLEEPBUTTON_ACTION
, 0x96996BC0, 0xAD50, 0x47EC, 0x92, 0x3B, 0x6F, 0x41, 0x87, 0x4D, 0xD9, 0xEB);
2762 DEFINE_GUID(GUID_SLEEPBUTTON_ACTION_FLAGS
, 0x2A160AB1, 0xB69D, 0x4743, 0xB7, 0x18, 0xBF, 0x14, 0x41, 0xD5, 0xE4, 0x93);
2763 DEFINE_GUID(GUID_USERINTERFACEBUTTON_ACTION
, 0xA7066653, 0x8D6C, 0x40A8, 0x91, 0x0E, 0xA1, 0xF5, 0x4B, 0x84, 0xC7, 0xE5);
2764 DEFINE_GUID(GUID_LIDCLOSE_ACTION
, 0x5CA83367, 0x6E45, 0x459F, 0xA2, 0x7B, 0x47, 0x6B, 0x1D, 0x01, 0xC9, 0x36);
2765 DEFINE_GUID(GUID_LIDCLOSE_ACTION_FLAGS
, 0x97E969AC, 0x0D6C, 0x4D08, 0x92, 0x7C, 0xD7, 0xBD, 0x7A, 0xD7, 0x85, 0x7B);
2766 DEFINE_GUID(GUID_LIDOPEN_POWERSTATE
, 0x99FF10E7, 0x23B1, 0x4C07, 0xA9, 0xD1, 0x5C, 0x32, 0x06, 0xD7, 0x41, 0xB4);
2767 DEFINE_GUID(GUID_BATTERY_SUBGROUP
, 0xE73A048D, 0xBF27, 0x4F12, 0x97, 0x31, 0x8B, 0x20, 0x76, 0xE8, 0x89, 0x1F);
2768 DEFINE_GUID(GUID_BATTERY_DISCHARGE_ACTION_0
, 0x637EA02F, 0xBBCB, 0x4015, 0x8E, 0x2C, 0xA1, 0xC7, 0xB9, 0xC0, 0xB5, 0x46);
2769 DEFINE_GUID(GUID_BATTERY_DISCHARGE_LEVEL_0
, 0x9A66D8D7, 0x4FF7, 0x4EF9, 0xB5, 0xA2, 0x5A, 0x32, 0x6C, 0xA2, 0xA4, 0x69);
2770 DEFINE_GUID(GUID_BATTERY_DISCHARGE_FLAGS_0
, 0x5dbb7c9f, 0x38e9, 0x40d2, 0x97, 0x49, 0x4f, 0x8a, 0x0e, 0x9f, 0x64, 0x0f);
2771 DEFINE_GUID(GUID_BATTERY_DISCHARGE_ACTION_1
, 0xD8742DCB, 0x3E6A, 0x4B3C, 0xB3, 0xFE, 0x37, 0x46, 0x23, 0xCD, 0xCF, 0x06);
2772 DEFINE_GUID(GUID_BATTERY_DISCHARGE_LEVEL_1
, 0x8183BA9A, 0xE910, 0x48DA, 0x87, 0x69, 0x14, 0xAE, 0x6D, 0xC1, 0x17, 0x0A);
2773 DEFINE_GUID(GUID_BATTERY_DISCHARGE_FLAGS_1
, 0xbcded951, 0x187b, 0x4d05, 0xbc, 0xcc, 0xf7, 0xe5, 0x19, 0x60, 0xc2, 0x58);
2774 DEFINE_GUID(GUID_BATTERY_DISCHARGE_ACTION_2
, 0x421CBA38, 0x1A8E, 0x4881, 0xAC, 0x89, 0xE3, 0x3A, 0x8B, 0x04, 0xEC, 0xE4);
2775 DEFINE_GUID(GUID_BATTERY_DISCHARGE_LEVEL_2
, 0x07A07CA2, 0xADAF, 0x40D7, 0xB0, 0x77, 0x53, 0x3A, 0xAD, 0xED, 0x1B, 0xFA);
2776 DEFINE_GUID(GUID_BATTERY_DISCHARGE_FLAGS_2
, 0x7fd2f0c4, 0xfeb7, 0x4da3, 0x81, 0x17, 0xe3, 0xfb, 0xed, 0xc4, 0x65, 0x82);
2777 DEFINE_GUID(GUID_BATTERY_DISCHARGE_ACTION_3
, 0x80472613, 0x9780, 0x455E, 0xB3, 0x08, 0x72, 0xD3, 0x00, 0x3C, 0xF2, 0xF8);
2778 DEFINE_GUID(GUID_BATTERY_DISCHARGE_LEVEL_3
, 0x58AFD5A6, 0xC2DD, 0x47D2, 0x9F, 0xBF, 0xEF, 0x70, 0xCC, 0x5C, 0x59, 0x65);
2779 DEFINE_GUID(GUID_BATTERY_DISCHARGE_FLAGS_3
, 0x73613ccf, 0xdbfa, 0x4279, 0x83, 0x56, 0x49, 0x35, 0xf6, 0xbf, 0x62, 0xf3);
2780 DEFINE_GUID(GUID_PROCESSOR_SETTINGS_SUBGROUP
, 0x54533251, 0x82BE, 0x4824, 0x96, 0xC1, 0x47, 0xB6, 0x0B, 0x74, 0x0D, 0x00);
2781 DEFINE_GUID(GUID_PROCESSOR_THROTTLE_POLICY
, 0x57027304, 0x4AF6, 0x4104, 0x92, 0x60, 0xE3, 0xD9, 0x52, 0x48, 0xFC, 0x36);
2782 DEFINE_GUID(GUID_PROCESSOR_THROTTLE_MAXIMUM
, 0xBC5038F7, 0x23E0, 0x4960, 0x96, 0xDA, 0x33, 0xAB, 0xAF, 0x59, 0x35, 0xEC);
2783 DEFINE_GUID(GUID_PROCESSOR_THROTTLE_MINIMUM
, 0x893DEE8E, 0x2BEF, 0x41E0, 0x89, 0xC6, 0xB5, 0x5D, 0x09, 0x29, 0x96, 0x4C);
2784 DEFINE_GUID(GUID_PROCESSOR_ALLOW_THROTTLING
, 0x3b04d4fd, 0x1cc7, 0x4f23, 0xab, 0x1c, 0xd1, 0x33, 0x78, 0x19, 0xc4, 0xbb);
2785 DEFINE_GUID(GUID_PROCESSOR_IDLESTATE_POLICY
, 0x68f262a7, 0xf621, 0x4069, 0xb9, 0xa5, 0x48, 0x74, 0x16, 0x9b, 0xe2, 0x3c);
2786 DEFINE_GUID(GUID_PROCESSOR_PERFSTATE_POLICY
, 0xBBDC3814, 0x18E9, 0x4463, 0x8A, 0x55, 0xD1, 0x97, 0x32, 0x7C, 0x45, 0xC0);
2787 DEFINE_GUID(GUID_PROCESSOR_PERF_INCREASE_THRESHOLD
, 0x06cadf0e, 0x64ed, 0x448a, 0x89, 0x27, 0xce, 0x7b, 0xf9, 0x0e, 0xb3, 0x5d);
2788 DEFINE_GUID(GUID_PROCESSOR_PERF_DECREASE_THRESHOLD
, 0x12a0ab44, 0xfe28, 0x4fa9, 0xb3, 0xbd, 0x4b, 0x64, 0xf4, 0x49, 0x60, 0xa6);
2789 DEFINE_GUID(GUID_PROCESSOR_PERF_INCREASE_POLICY
, 0x465e1f50, 0xb610, 0x473a, 0xab, 0x58, 0x0, 0xd1, 0x7, 0x7d, 0xc4, 0x18);
2790 DEFINE_GUID(GUID_PROCESSOR_PERF_DECREASE_POLICY
, 0x40fbefc7, 0x2e9d, 0x4d25, 0xa1, 0x85, 0xc, 0xfd, 0x85, 0x74, 0xba, 0xc6);
2791 DEFINE_GUID(GUID_PROCESSOR_PERF_INCREASE_TIME
, 0x984cf492, 0x3bed, 0x4488, 0xa8, 0xf9, 0x42, 0x86, 0xc9, 0x7b, 0xf5, 0xaa);
2792 DEFINE_GUID(GUID_PROCESSOR_PERF_DECREASE_TIME
, 0xd8edeb9b, 0x95cf, 0x4f95, 0xa7, 0x3c, 0xb0, 0x61, 0x97, 0x36, 0x93, 0xc8);
2793 DEFINE_GUID(GUID_PROCESSOR_PERF_TIME_CHECK
, 0x4d2b0152, 0x7d5c, 0x498b, 0x88, 0xe2, 0x34, 0x34, 0x53, 0x92, 0xa2, 0xc5);
2794 DEFINE_GUID(GUID_PROCESSOR_PERF_BOOST_POLICY
, 0x45bcc044, 0xd885, 0x43e2, 0x86, 0x5, 0xee, 0xe, 0xc6, 0xe9, 0x6b, 0x59);
2795 DEFINE_GUID(GUID_PROCESSOR_IDLE_ALLOW_SCALING
, 0x6c2993b0, 0x8f48, 0x481f, 0xbc, 0xc6, 0x0, 0xdd, 0x27, 0x42, 0xaa, 0x6);
2796 DEFINE_GUID(GUID_PROCESSOR_IDLE_DISABLE
, 0x5d76a2ca, 0xe8c0, 0x402f, 0xa1, 0x33, 0x21, 0x58, 0x49, 0x2d, 0x58, 0xad);
2797 DEFINE_GUID(GUID_PROCESSOR_IDLE_TIME_CHECK
, 0xc4581c31, 0x89ab, 0x4597, 0x8e, 0x2b, 0x9c, 0x9c, 0xab, 0x44, 0xe, 0x6b);
2798 DEFINE_GUID(GUID_PROCESSOR_IDLE_DEMOTE_THRESHOLD
, 0x4b92d758, 0x5a24, 0x4851, 0xa4, 0x70, 0x81, 0x5d, 0x78, 0xae, 0xe1, 0x19);
2799 DEFINE_GUID(GUID_PROCESSOR_IDLE_PROMOTE_THRESHOLD
, 0x7b224883, 0xb3cc, 0x4d79, 0x81, 0x9f, 0x83, 0x74, 0x15, 0x2c, 0xbe, 0x7c);
2800 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_INCREASE_THRESHOLD
, 0xdf142941, 0x20f3, 0x4edf, 0x9a, 0x4a, 0x9c, 0x83, 0xd3, 0xd7, 0x17, 0xd1);
2801 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_DECREASE_THRESHOLD
, 0x68dd2f27, 0xa4ce, 0x4e11, 0x84, 0x87, 0x37, 0x94, 0xe4, 0x13, 0x5d, 0xfa);
2802 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_INCREASE_POLICY
, 0xc7be0679, 0x2817, 0x4d69, 0x9d, 0x02, 0x51, 0x9a, 0x53, 0x7e, 0xd0, 0xc6);
2803 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_DECREASE_POLICY
, 0x71021b41, 0xc749, 0x4d21, 0xbe, 0x74, 0xa0, 0x0f, 0x33, 0x5d, 0x58, 0x2b);
2804 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_MAX_CORES
, 0xea062031, 0x0e34, 0x4ff1, 0x9b, 0x6d, 0xeb, 0x10, 0x59, 0x33, 0x40, 0x28);
2805 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_MIN_CORES
, 0x0cc5b647, 0xc1df, 0x4637, 0x89, 0x1a, 0xde, 0xc3, 0x5c, 0x31, 0x85, 0x83);
2806 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_INCREASE_TIME
, 0x2ddd5a84, 0x5a71, 0x437e, 0x91, 0x2a, 0xdb, 0x0b, 0x8c, 0x78, 0x87, 0x32);
2807 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_DECREASE_TIME
, 0xdfd10d17, 0xd5eb, 0x45dd, 0x87, 0x7a, 0x9a, 0x34, 0xdd, 0xd1, 0x5c, 0x82);
2808 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_AFFINITY_HISTORY_DECREASE_FACTOR
, 0x8f7b45e3, 0xc393, 0x480a, 0x87, 0x8c, 0xf6, 0x7a, 0xc3, 0xd0, 0x70, 0x82);
2809 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_AFFINITY_HISTORY_THRESHOLD
, 0x5b33697b, 0xe89d, 0x4d38, 0xaa, 0x46, 0x9e, 0x7d, 0xfb, 0x7c, 0xd2, 0xf9);
2810 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_AFFINITY_WEIGHTING
, 0xe70867f1, 0xfa2f, 0x4f4e, 0xae, 0xa1, 0x4d, 0x8a, 0x0b, 0xa2, 0x3b, 0x20);
2811 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_OVER_UTILIZATION_HISTORY_DECREASE_FACTOR
, 0x1299023c, 0xbc28, 0x4f0a, 0x81, 0xec, 0xd3, 0x29, 0x5a, 0x8d, 0x81, 0x5d);
2812 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_OVER_UTILIZATION_HISTORY_THRESHOLD
, 0x9ac18e92, 0xaa3c, 0x4e27, 0xb3, 0x07, 0x01, 0xae, 0x37, 0x30, 0x71, 0x29);
2813 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_OVER_UTILIZATION_WEIGHTING
, 0x8809c2d8, 0xb155, 0x42d4, 0xbc, 0xda, 0x0d, 0x34, 0x56, 0x51, 0xb1, 0xdb);
2814 DEFINE_GUID(GUID_PROCESSOR_CORE_PARKING_OVER_UTILIZATION_THRESHOLD
, 0x943c8cb6, 0x6f93, 0x4227, 0xad, 0x87, 0xe9, 0xa3, 0xfe, 0xec, 0x08, 0xd1);
2815 DEFINE_GUID(GUID_PROCESSOR_PARKING_CORE_OVERRIDE
, 0xa55612aa, 0xf624, 0x42c6, 0xa4, 0x43, 0x73, 0x97, 0xd0, 0x64, 0xc0, 0x4f);
2816 DEFINE_GUID(GUID_PROCESSOR_PARKING_PERF_STATE
, 0x447235c7, 0x6a8d, 0x4cc0, 0x8e, 0x24, 0x9e, 0xaf, 0x70, 0xb9, 0x6e, 0x2b);
2817 DEFINE_GUID(GUID_PROCESSOR_PERF_HISTORY
, 0x7d24baa7, 0x0b84, 0x480f, 0x84, 0x0c, 0x1b, 0x07, 0x43, 0xc0, 0x0f, 0x5f);
2818 DEFINE_GUID(GUID_SYSTEM_COOLING_POLICY
, 0x94D3A615, 0xA899, 0x4AC5, 0xAE, 0x2B, 0xE4, 0xD8, 0xF6, 0x34, 0x36, 0x7F);
2819 DEFINE_GUID(GUID_LOCK_CONSOLE_ON_WAKE
, 0x0E796BDB, 0x100D, 0x47D6, 0xA2, 0xD5, 0xF7, 0xD2, 0xDA, 0xA5, 0x1F, 0x51);
2820 DEFINE_GUID(GUID_DEVICE_IDLE_POLICY
, 0x4faab71a, 0x92e5, 0x4726, 0xb5, 0x31, 0x22, 0x45, 0x59, 0x67, 0x2d, 0x19);
2821 DEFINE_GUID(GUID_ACDC_POWER_SOURCE
, 0x5D3E9A59, 0xE9D5, 0x4B00, 0xA6, 0xBD, 0xFF, 0x34, 0xFF, 0x51, 0x65, 0x48);
2822 DEFINE_GUID(GUID_LIDSWITCH_STATE_CHANGE
, 0xBA3E0F4D, 0xB817, 0x4094, 0xA2, 0xD1, 0xD5, 0x63, 0x79, 0xE6, 0xA0, 0xF3);
2823 DEFINE_GUID(GUID_BATTERY_PERCENTAGE_REMAINING
, 0xA7AD8041, 0xB45A, 0x4CAE, 0x87, 0xA3, 0xEE, 0xCB, 0xB4, 0x68, 0xA9, 0xE1);
2824 DEFINE_GUID(GUID_IDLE_BACKGROUND_TASK
, 0x515C31D8, 0xF734, 0x163D, 0xA0, 0xFD, 0x11, 0xA0, 0x8C, 0x91, 0xE8, 0xF1);
2825 DEFINE_GUID(GUID_BACKGROUND_TASK_NOTIFICATION
, 0xCF23F240, 0x2A54, 0x48D8, 0xB1, 0x14, 0xDE, 0x15, 0x18, 0xFF, 0x05, 0x2E);
2826 DEFINE_GUID(GUID_APPLAUNCH_BUTTON
, 0x1A689231, 0x7399, 0x4E9A, 0x8F, 0x99, 0xB7, 0x1F, 0x99, 0x9D, 0xB3, 0xFA);
2827 DEFINE_GUID(GUID_PCIEXPRESS_SETTINGS_SUBGROUP
, 0x501a4d13, 0x42af,0x4429, 0x9f, 0xd1, 0xa8, 0x21, 0x8c, 0x26, 0x8e, 0x20);
2828 DEFINE_GUID(GUID_PCIEXPRESS_ASPM_POLICY
, 0xee12f906, 0xd277, 0x404b, 0xb6, 0xda, 0xe5, 0xfa, 0x1a, 0x57, 0x6d, 0xf5);
2829 DEFINE_GUID(GUID_ENABLE_SWITCH_FORCED_SHUTDOWN
, 0x833a6b62, 0xdfa4, 0x46d1, 0x82, 0xf8, 0xe0, 0x9e, 0x34, 0xd0, 0x29, 0xd6);
2831 #define PERFSTATE_POLICY_CHANGE_IDEAL 0
2832 #define PERFSTATE_POLICY_CHANGE_SINGLE 1
2833 #define PERFSTATE_POLICY_CHANGE_ROCKET 2
2834 #define PERFSTATE_POLICY_CHANGE_MAX PERFSTATE_POLICY_CHANGE_ROCKET
2836 #define PROCESSOR_PERF_BOOST_POLICY_DISABLED 0
2837 #define PROCESSOR_PERF_BOOST_POLICY_MAX 100
2839 #define POWER_DEVICE_IDLE_POLICY_PERFORMANCE 0
2840 #define POWER_DEVICE_IDLE_POLICY_CONSERVATIVE 1
2842 _Function_class_(REQUEST_POWER_COMPLETE
)
2843 _IRQL_requires_same_
2845 (NTAPI REQUEST_POWER_COMPLETE
)(
2846 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
2847 _In_ UCHAR MinorFunction
,
2848 _In_ POWER_STATE PowerState
,
2849 _In_opt_ PVOID Context
,
2850 _In_
struct _IO_STATUS_BLOCK
*IoStatus
);
2851 typedef REQUEST_POWER_COMPLETE
*PREQUEST_POWER_COMPLETE
;
2853 _Function_class_(POWER_SETTING_CALLBACK
)
2854 _IRQL_requires_same_
2856 (NTAPI POWER_SETTING_CALLBACK
)(
2857 _In_ LPCGUID SettingGuid
,
2858 _In_reads_bytes_(ValueLength
) PVOID Value
,
2859 _In_ ULONG ValueLength
,
2860 _Inout_opt_ PVOID Context
);
2861 typedef POWER_SETTING_CALLBACK
*PPOWER_SETTING_CALLBACK
;
2863 /******************************************************************************
2864 * Configuration Manager Types *
2865 ******************************************************************************/
2867 /* Resource list definitions */
2868 typedef int CM_RESOURCE_TYPE
;
2870 #define CmResourceTypeNull 0
2871 #define CmResourceTypePort 1
2872 #define CmResourceTypeInterrupt 2
2873 #define CmResourceTypeMemory 3
2874 #define CmResourceTypeDma 4
2875 #define CmResourceTypeDeviceSpecific 5
2876 #define CmResourceTypeBusNumber 6
2877 #define CmResourceTypeNonArbitrated 128
2878 #define CmResourceTypeConfigData 128
2879 #define CmResourceTypeDevicePrivate 129
2880 #define CmResourceTypePcCardConfig 130
2881 #define CmResourceTypeMfCardConfig 131
2883 /* KEY_VALUE_Xxx.Type */
2886 #define REG_EXPAND_SZ 2
2887 #define REG_BINARY 3
2889 #define REG_DWORD_LITTLE_ENDIAN 4
2890 #define REG_DWORD_BIG_ENDIAN 5
2892 #define REG_MULTI_SZ 7
2893 #define REG_RESOURCE_LIST 8
2894 #define REG_FULL_RESOURCE_DESCRIPTOR 9
2895 #define REG_RESOURCE_REQUIREMENTS_LIST 10
2896 #define REG_QWORD 11
2897 #define REG_QWORD_LITTLE_ENDIAN 11
2899 /* Registry Access Rights */
2900 #define KEY_QUERY_VALUE (0x0001)
2901 #define KEY_SET_VALUE (0x0002)
2902 #define KEY_CREATE_SUB_KEY (0x0004)
2903 #define KEY_ENUMERATE_SUB_KEYS (0x0008)
2904 #define KEY_NOTIFY (0x0010)
2905 #define KEY_CREATE_LINK (0x0020)
2906 #define KEY_WOW64_32KEY (0x0200)
2907 #define KEY_WOW64_64KEY (0x0100)
2908 #define KEY_WOW64_RES (0x0300)
2910 #define KEY_READ ((STANDARD_RIGHTS_READ |\
2912 KEY_ENUMERATE_SUB_KEYS |\
2917 #define KEY_WRITE ((STANDARD_RIGHTS_WRITE |\
2919 KEY_CREATE_SUB_KEY) \
2923 #define KEY_EXECUTE ((KEY_READ) \
2927 #define KEY_ALL_ACCESS ((STANDARD_RIGHTS_ALL |\
2930 KEY_CREATE_SUB_KEY |\
2931 KEY_ENUMERATE_SUB_KEYS |\
2937 /* Registry Open/Create Options */
2938 #define REG_OPTION_RESERVED (0x00000000L)
2939 #define REG_OPTION_NON_VOLATILE (0x00000000L)
2940 #define REG_OPTION_VOLATILE (0x00000001L)
2941 #define REG_OPTION_CREATE_LINK (0x00000002L)
2942 #define REG_OPTION_BACKUP_RESTORE (0x00000004L)
2943 #define REG_OPTION_OPEN_LINK (0x00000008L)
2945 #define REG_LEGAL_OPTION \
2946 (REG_OPTION_RESERVED |\
2947 REG_OPTION_NON_VOLATILE |\
2948 REG_OPTION_VOLATILE |\
2949 REG_OPTION_CREATE_LINK |\
2950 REG_OPTION_BACKUP_RESTORE |\
2951 REG_OPTION_OPEN_LINK)
2953 #define REG_OPEN_LEGAL_OPTION \
2954 (REG_OPTION_RESERVED |\
2955 REG_OPTION_BACKUP_RESTORE |\
2956 REG_OPTION_OPEN_LINK)
2958 #define REG_STANDARD_FORMAT 1
2959 #define REG_LATEST_FORMAT 2
2960 #define REG_NO_COMPRESSION 4
2962 /* Key creation/open disposition */
2963 #define REG_CREATED_NEW_KEY (0x00000001L)
2964 #define REG_OPENED_EXISTING_KEY (0x00000002L)
2966 /* Key restore & hive load flags */
2967 #define REG_WHOLE_HIVE_VOLATILE (0x00000001L)
2968 #define REG_REFRESH_HIVE (0x00000002L)
2969 #define REG_NO_LAZY_FLUSH (0x00000004L)
2970 #define REG_FORCE_RESTORE (0x00000008L)
2971 #define REG_APP_HIVE (0x00000010L)
2972 #define REG_PROCESS_PRIVATE (0x00000020L)
2973 #define REG_START_JOURNAL (0x00000040L)
2974 #define REG_HIVE_EXACT_FILE_GROWTH (0x00000080L)
2975 #define REG_HIVE_NO_RM (0x00000100L)
2976 #define REG_HIVE_SINGLE_LOG (0x00000200L)
2977 #define REG_BOOT_HIVE (0x00000400L)
2980 #define REG_FORCE_UNLOAD 1
2982 /* Notify Filter Values */
2983 #define REG_NOTIFY_CHANGE_NAME (0x00000001L)
2984 #define REG_NOTIFY_CHANGE_ATTRIBUTES (0x00000002L)
2985 #define REG_NOTIFY_CHANGE_LAST_SET (0x00000004L)
2986 #define REG_NOTIFY_CHANGE_SECURITY (0x00000008L)
2988 #define REG_LEGAL_CHANGE_FILTER \
2989 (REG_NOTIFY_CHANGE_NAME |\
2990 REG_NOTIFY_CHANGE_ATTRIBUTES |\
2991 REG_NOTIFY_CHANGE_LAST_SET |\
2992 REG_NOTIFY_CHANGE_SECURITY)
2994 #include <pshpack4.h>
2995 typedef struct _CM_PARTIAL_RESOURCE_DESCRIPTOR
{
2997 UCHAR ShareDisposition
;
3001 PHYSICAL_ADDRESS Start
;
3005 PHYSICAL_ADDRESS Start
;
3009 #if defined(NT_PROCESSOR_GROUPS)
3018 #if (NTDDI_VERSION >= NTDDI_LONGHORN)
3020 _ANONYMOUS_UNION
union {
3022 #if defined(NT_PROCESSOR_GROUPS)
3027 USHORT MessageCount
;
3032 #if defined(NT_PROCESSOR_GROUPS)
3045 PHYSICAL_ADDRESS Start
;
3065 } DeviceSpecificData
;
3066 #if (NTDDI_VERSION >= NTDDI_LONGHORN)
3068 PHYSICAL_ADDRESS Start
;
3072 PHYSICAL_ADDRESS Start
;
3076 PHYSICAL_ADDRESS Start
;
3081 } CM_PARTIAL_RESOURCE_DESCRIPTOR
, *PCM_PARTIAL_RESOURCE_DESCRIPTOR
;
3082 #include <poppack.h>
3084 /* CM_PARTIAL_RESOURCE_DESCRIPTOR.Type */
3085 #define CmResourceTypeNull 0
3086 #define CmResourceTypePort 1
3087 #define CmResourceTypeInterrupt 2
3088 #define CmResourceTypeMemory 3
3089 #define CmResourceTypeDma 4
3090 #define CmResourceTypeDeviceSpecific 5
3091 #define CmResourceTypeBusNumber 6
3092 #define CmResourceTypeMemoryLarge 7
3093 #define CmResourceTypeNonArbitrated 128
3094 #define CmResourceTypeConfigData 128
3095 #define CmResourceTypeDevicePrivate 129
3096 #define CmResourceTypePcCardConfig 130
3097 #define CmResourceTypeMfCardConfig 131
3099 /* CM_PARTIAL_RESOURCE_DESCRIPTOR.ShareDisposition */
3100 typedef enum _CM_SHARE_DISPOSITION
{
3101 CmResourceShareUndetermined
= 0,
3102 CmResourceShareDeviceExclusive
,
3103 CmResourceShareDriverExclusive
,
3104 CmResourceShareShared
3105 } CM_SHARE_DISPOSITION
;
3107 /* CM_PARTIAL_RESOURCE_DESCRIPTOR.Flags if Type = CmResourceTypePort */
3108 #define CM_RESOURCE_PORT_MEMORY 0x0000
3109 #define CM_RESOURCE_PORT_IO 0x0001
3110 #define CM_RESOURCE_PORT_10_BIT_DECODE 0x0004
3111 #define CM_RESOURCE_PORT_12_BIT_DECODE 0x0008
3112 #define CM_RESOURCE_PORT_16_BIT_DECODE 0x0010
3113 #define CM_RESOURCE_PORT_POSITIVE_DECODE 0x0020
3114 #define CM_RESOURCE_PORT_PASSIVE_DECODE 0x0040
3115 #define CM_RESOURCE_PORT_WINDOW_DECODE 0x0080
3116 #define CM_RESOURCE_PORT_BAR 0x0100
3118 /* CM_PARTIAL_RESOURCE_DESCRIPTOR.Flags if Type = CmResourceTypeInterrupt */
3119 #define CM_RESOURCE_INTERRUPT_LEVEL_SENSITIVE 0x0000
3120 #define CM_RESOURCE_INTERRUPT_LATCHED 0x0001
3121 #define CM_RESOURCE_INTERRUPT_MESSAGE 0x0002
3122 #define CM_RESOURCE_INTERRUPT_POLICY_INCLUDED 0x0004
3124 #define CM_RESOURCE_INTERRUPT_LEVEL_LATCHED_BITS 0x0001
3126 #define CM_RESOURCE_INTERRUPT_MESSAGE_TOKEN ((ULONG)-2)
3128 /* CM_PARTIAL_RESOURCE_DESCRIPTOR.Flags if Type = CmResourceTypeMemory */
3129 #define CM_RESOURCE_MEMORY_READ_WRITE 0x0000
3130 #define CM_RESOURCE_MEMORY_READ_ONLY 0x0001
3131 #define CM_RESOURCE_MEMORY_WRITE_ONLY 0x0002
3132 #define CM_RESOURCE_MEMORY_WRITEABILITY_MASK 0x0003
3133 #define CM_RESOURCE_MEMORY_PREFETCHABLE 0x0004
3134 #define CM_RESOURCE_MEMORY_COMBINEDWRITE 0x0008
3135 #define CM_RESOURCE_MEMORY_24 0x0010
3136 #define CM_RESOURCE_MEMORY_CACHEABLE 0x0020
3137 #define CM_RESOURCE_MEMORY_WINDOW_DECODE 0x0040
3138 #define CM_RESOURCE_MEMORY_BAR 0x0080
3139 #define CM_RESOURCE_MEMORY_COMPAT_FOR_INACCESSIBLE_RANGE 0x0100
3141 #define CM_RESOURCE_MEMORY_LARGE 0x0E00
3142 #define CM_RESOURCE_MEMORY_LARGE_40 0x0200
3143 #define CM_RESOURCE_MEMORY_LARGE_48 0x0400
3144 #define CM_RESOURCE_MEMORY_LARGE_64 0x0800
3146 #define CM_RESOURCE_MEMORY_LARGE_40_MAXLEN 0x000000FFFFFFFF00
3147 #define CM_RESOURCE_MEMORY_LARGE_48_MAXLEN 0x0000FFFFFFFF0000
3148 #define CM_RESOURCE_MEMORY_LARGE_64_MAXLEN 0xFFFFFFFF00000000
3150 /* CM_PARTIAL_RESOURCE_DESCRIPTOR.Flags if Type = CmResourceTypeDma */
3151 #define CM_RESOURCE_DMA_8 0x0000
3152 #define CM_RESOURCE_DMA_16 0x0001
3153 #define CM_RESOURCE_DMA_32 0x0002
3154 #define CM_RESOURCE_DMA_8_AND_16 0x0004
3155 #define CM_RESOURCE_DMA_BUS_MASTER 0x0008
3156 #define CM_RESOURCE_DMA_TYPE_A 0x0010
3157 #define CM_RESOURCE_DMA_TYPE_B 0x0020
3158 #define CM_RESOURCE_DMA_TYPE_F 0x0040
3160 typedef struct _DEVICE_FLAGS
{
3168 } DEVICE_FLAGS
, *PDEVICE_FLAGS
;
3170 typedef enum _INTERFACE_TYPE
{
3171 InterfaceTypeUndefined
= -1,
3189 MaximumInterfaceType
3190 } INTERFACE_TYPE
, *PINTERFACE_TYPE
;
3192 typedef struct _CM_COMPONENT_INFORMATION
{
3196 KAFFINITY AffinityMask
;
3197 } CM_COMPONENT_INFORMATION
, *PCM_COMPONENT_INFORMATION
;
3199 typedef struct _CM_ROM_BLOCK
{
3202 } CM_ROM_BLOCK
, *PCM_ROM_BLOCK
;
3204 typedef struct _CM_PARTIAL_RESOURCE_LIST
{
3208 CM_PARTIAL_RESOURCE_DESCRIPTOR PartialDescriptors
[1];
3209 } CM_PARTIAL_RESOURCE_LIST
, *PCM_PARTIAL_RESOURCE_LIST
;
3211 typedef struct _CM_FULL_RESOURCE_DESCRIPTOR
{
3212 INTERFACE_TYPE InterfaceType
;
3214 CM_PARTIAL_RESOURCE_LIST PartialResourceList
;
3215 } CM_FULL_RESOURCE_DESCRIPTOR
, *PCM_FULL_RESOURCE_DESCRIPTOR
;
3217 typedef struct _CM_RESOURCE_LIST
{
3219 CM_FULL_RESOURCE_DESCRIPTOR List
[1];
3220 } CM_RESOURCE_LIST
, *PCM_RESOURCE_LIST
;
3222 typedef struct _PNP_BUS_INFORMATION
{
3224 INTERFACE_TYPE LegacyBusType
;
3226 } PNP_BUS_INFORMATION
, *PPNP_BUS_INFORMATION
;
3228 #include <pshpack1.h>
3230 typedef struct _CM_INT13_DRIVE_PARAMETER
{
3233 USHORT SectorsPerTrack
;
3235 USHORT NumberDrives
;
3236 } CM_INT13_DRIVE_PARAMETER
, *PCM_INT13_DRIVE_PARAMETER
;
3238 typedef struct _CM_MCA_POS_DATA
{
3244 } CM_MCA_POS_DATA
, *PCM_MCA_POS_DATA
;
3246 typedef struct _CM_PNP_BIOS_DEVICE_NODE
{
3250 UCHAR DeviceType
[3];
3251 USHORT DeviceAttributes
;
3252 } CM_PNP_BIOS_DEVICE_NODE
,*PCM_PNP_BIOS_DEVICE_NODE
;
3254 typedef struct _CM_PNP_BIOS_INSTALLATION_CHECK
{
3258 USHORT ControlField
;
3260 ULONG EventFlagAddress
;
3261 USHORT RealModeEntryOffset
;
3262 USHORT RealModeEntrySegment
;
3263 USHORT ProtectedModeEntryOffset
;
3264 ULONG ProtectedModeCodeBaseAddress
;
3266 USHORT RealModeDataBaseAddress
;
3267 ULONG ProtectedModeDataBaseAddress
;
3268 } CM_PNP_BIOS_INSTALLATION_CHECK
, *PCM_PNP_BIOS_INSTALLATION_CHECK
;
3270 #include <poppack.h>
3272 typedef struct _CM_DISK_GEOMETRY_DEVICE_DATA
{
3273 ULONG BytesPerSector
;
3274 ULONG NumberOfCylinders
;
3275 ULONG SectorsPerTrack
;
3276 ULONG NumberOfHeads
;
3277 } CM_DISK_GEOMETRY_DEVICE_DATA
, *PCM_DISK_GEOMETRY_DEVICE_DATA
;
3279 typedef struct _CM_KEYBOARD_DEVICE_DATA
{
3284 USHORT KeyboardFlags
;
3285 } CM_KEYBOARD_DEVICE_DATA
, *PCM_KEYBOARD_DEVICE_DATA
;
3287 typedef struct _CM_SCSI_DEVICE_DATA
{
3290 UCHAR HostIdentifier
;
3291 } CM_SCSI_DEVICE_DATA
, *PCM_SCSI_DEVICE_DATA
;
3293 typedef struct _CM_VIDEO_DEVICE_DATA
{
3297 } CM_VIDEO_DEVICE_DATA
, *PCM_VIDEO_DEVICE_DATA
;
3299 typedef struct _CM_SONIC_DEVICE_DATA
{
3302 USHORT DataConfigurationRegister
;
3303 UCHAR EthernetAddress
[8];
3304 } CM_SONIC_DEVICE_DATA
, *PCM_SONIC_DEVICE_DATA
;
3306 typedef struct _CM_SERIAL_DEVICE_DATA
{
3310 } CM_SERIAL_DEVICE_DATA
, *PCM_SERIAL_DEVICE_DATA
;
3312 typedef struct _CM_MONITOR_DEVICE_DATA
{
3315 USHORT HorizontalScreenSize
;
3316 USHORT VerticalScreenSize
;
3317 USHORT HorizontalResolution
;
3318 USHORT VerticalResolution
;
3319 USHORT HorizontalDisplayTimeLow
;
3320 USHORT HorizontalDisplayTime
;
3321 USHORT HorizontalDisplayTimeHigh
;
3322 USHORT HorizontalBackPorchLow
;
3323 USHORT HorizontalBackPorch
;
3324 USHORT HorizontalBackPorchHigh
;
3325 USHORT HorizontalFrontPorchLow
;
3326 USHORT HorizontalFrontPorch
;
3327 USHORT HorizontalFrontPorchHigh
;
3328 USHORT HorizontalSyncLow
;
3329 USHORT HorizontalSync
;
3330 USHORT HorizontalSyncHigh
;
3331 USHORT VerticalBackPorchLow
;
3332 USHORT VerticalBackPorch
;
3333 USHORT VerticalBackPorchHigh
;
3334 USHORT VerticalFrontPorchLow
;
3335 USHORT VerticalFrontPorch
;
3336 USHORT VerticalFrontPorchHigh
;
3337 USHORT VerticalSyncLow
;
3338 USHORT VerticalSync
;
3339 USHORT VerticalSyncHigh
;
3340 } CM_MONITOR_DEVICE_DATA
, *PCM_MONITOR_DEVICE_DATA
;
3342 typedef struct _CM_FLOPPY_DEVICE_DATA
{
3348 UCHAR StepRateHeadUnloadTime
;
3351 UCHAR SectorLengthCode
;
3352 UCHAR SectorPerTrack
;
3353 UCHAR ReadWriteGapLength
;
3354 UCHAR DataTransferLength
;
3355 UCHAR FormatGapLength
;
3356 UCHAR FormatFillCharacter
;
3357 UCHAR HeadSettleTime
;
3358 UCHAR MotorSettleTime
;
3359 UCHAR MaximumTrackValue
;
3360 UCHAR DataTransferRate
;
3361 } CM_FLOPPY_DEVICE_DATA
, *PCM_FLOPPY_DEVICE_DATA
;
3363 typedef enum _KEY_INFORMATION_CLASS
{
3364 KeyBasicInformation
,
3368 KeyCachedInformation
,
3369 KeyFlagsInformation
,
3370 KeyVirtualizationInformation
,
3371 KeyHandleTagsInformation
,
3373 } KEY_INFORMATION_CLASS
;
3375 typedef struct _KEY_BASIC_INFORMATION
{
3376 LARGE_INTEGER LastWriteTime
;
3380 } KEY_BASIC_INFORMATION
, *PKEY_BASIC_INFORMATION
;
3382 typedef struct _KEY_CONTROL_FLAGS_INFORMATION
{
3384 } KEY_CONTROL_FLAGS_INFORMATION
, *PKEY_CONTROL_FLAGS_INFORMATION
;
3386 typedef struct _KEY_FULL_INFORMATION
{
3387 LARGE_INTEGER LastWriteTime
;
3395 ULONG MaxValueNameLen
;
3396 ULONG MaxValueDataLen
;
3398 } KEY_FULL_INFORMATION
, *PKEY_FULL_INFORMATION
;
3400 typedef struct _KEY_HANDLE_TAGS_INFORMATION
{
3402 } KEY_HANDLE_TAGS_INFORMATION
, *PKEY_HANDLE_TAGS_INFORMATION
;
3404 typedef struct _KEY_NODE_INFORMATION
{
3405 LARGE_INTEGER LastWriteTime
;
3411 } KEY_NODE_INFORMATION
, *PKEY_NODE_INFORMATION
;
3413 typedef enum _KEY_SET_INFORMATION_CLASS
{
3414 KeyWriteTimeInformation
,
3415 KeyWow64FlagsInformation
,
3416 KeyControlFlagsInformation
,
3417 KeySetVirtualizationInformation
,
3418 KeySetDebugInformation
,
3419 KeySetHandleTagsInformation
,
3421 } KEY_SET_INFORMATION_CLASS
;
3423 typedef struct _KEY_SET_VIRTUALIZATION_INFORMATION
{
3424 ULONG VirtualTarget
:1;
3425 ULONG VirtualStore
:1;
3426 ULONG VirtualSource
:1;
3428 } KEY_SET_VIRTUALIZATION_INFORMATION
, *PKEY_SET_VIRTUALIZATION_INFORMATION
;
3430 typedef struct _KEY_VALUE_BASIC_INFORMATION
{
3435 } KEY_VALUE_BASIC_INFORMATION
, *PKEY_VALUE_BASIC_INFORMATION
;
3437 typedef struct _KEY_VALUE_FULL_INFORMATION
{
3444 } KEY_VALUE_FULL_INFORMATION
, *PKEY_VALUE_FULL_INFORMATION
;
3446 typedef struct _KEY_VALUE_PARTIAL_INFORMATION
{
3450 _Field_size_bytes_(DataLength
) UCHAR Data
[1];
3451 } KEY_VALUE_PARTIAL_INFORMATION
, *PKEY_VALUE_PARTIAL_INFORMATION
;
3453 typedef struct _KEY_VALUE_PARTIAL_INFORMATION_ALIGN64
{
3456 _Field_size_bytes_(DataLength
) UCHAR Data
[1];
3457 } KEY_VALUE_PARTIAL_INFORMATION_ALIGN64
, *PKEY_VALUE_PARTIAL_INFORMATION_ALIGN64
;
3459 typedef struct _KEY_VALUE_ENTRY
{
3460 PUNICODE_STRING ValueName
;
3464 } KEY_VALUE_ENTRY
, *PKEY_VALUE_ENTRY
;
3466 typedef enum _KEY_VALUE_INFORMATION_CLASS
{
3467 KeyValueBasicInformation
,
3468 KeyValueFullInformation
,
3469 KeyValuePartialInformation
,
3470 KeyValueFullInformationAlign64
,
3471 KeyValuePartialInformationAlign64
3472 } KEY_VALUE_INFORMATION_CLASS
;
3474 typedef struct _KEY_WOW64_FLAGS_INFORMATION
{
3476 } KEY_WOW64_FLAGS_INFORMATION
, *PKEY_WOW64_FLAGS_INFORMATION
;
3478 typedef struct _KEY_WRITE_TIME_INFORMATION
{
3479 LARGE_INTEGER LastWriteTime
;
3480 } KEY_WRITE_TIME_INFORMATION
, *PKEY_WRITE_TIME_INFORMATION
;
3482 #if (NTDDI_VERSION < NTDDI_VISTA)
3483 typedef struct _KEY_USER_FLAGS_INFORMATION
{
3485 } KEY_USER_FLAGS_INFORMATION
, *PKEY_USER_FLAGS_INFORMATION
;
3488 typedef enum _REG_NOTIFY_CLASS
{
3490 RegNtPreDeleteKey
= RegNtDeleteKey
,
3492 RegNtPreSetValueKey
= RegNtSetValueKey
,
3493 RegNtDeleteValueKey
,
3494 RegNtPreDeleteValueKey
= RegNtDeleteValueKey
,
3495 RegNtSetInformationKey
,
3496 RegNtPreSetInformationKey
= RegNtSetInformationKey
,
3498 RegNtPreRenameKey
= RegNtRenameKey
,
3500 RegNtPreEnumerateKey
= RegNtEnumerateKey
,
3501 RegNtEnumerateValueKey
,
3502 RegNtPreEnumerateValueKey
= RegNtEnumerateValueKey
,
3504 RegNtPreQueryKey
= RegNtQueryKey
,
3506 RegNtPreQueryValueKey
= RegNtQueryValueKey
,
3507 RegNtQueryMultipleValueKey
,
3508 RegNtPreQueryMultipleValueKey
= RegNtQueryMultipleValueKey
,
3513 RegNtKeyHandleClose
,
3514 RegNtPreKeyHandleClose
= RegNtKeyHandleClose
,
3516 RegNtPostSetValueKey
,
3517 RegNtPostDeleteValueKey
,
3518 RegNtPostSetInformationKey
,
3520 RegNtPostEnumerateKey
,
3521 RegNtPostEnumerateValueKey
,
3523 RegNtPostQueryValueKey
,
3524 RegNtPostQueryMultipleValueKey
,
3525 RegNtPostKeyHandleClose
,
3526 RegNtPreCreateKeyEx
,
3527 RegNtPostCreateKeyEx
,
3536 RegNtPreQueryKeySecurity
,
3537 RegNtPostQueryKeySecurity
,
3538 RegNtPreSetKeySecurity
,
3539 RegNtPostSetKeySecurity
,
3540 RegNtCallbackObjectContextCleanup
,
3542 RegNtPostRestoreKey
,
3546 RegNtPostReplaceKey
,
3548 } REG_NOTIFY_CLASS
, *PREG_NOTIFY_CLASS
;
3550 _IRQL_requires_same_
3551 _Function_class_(EX_CALLBACK_FUNCTION
)
3553 (NTAPI EX_CALLBACK_FUNCTION
)(
3554 _In_ PVOID CallbackContext
,
3555 _In_opt_ PVOID Argument1
,
3556 _In_opt_ PVOID Argument2
);
3557 typedef EX_CALLBACK_FUNCTION
*PEX_CALLBACK_FUNCTION
;
3559 typedef struct _REG_DELETE_KEY_INFORMATION
{
3562 PVOID ObjectContext
;
3564 } REG_DELETE_KEY_INFORMATION
, *PREG_DELETE_KEY_INFORMATION
3565 #if (NTDDI_VERSION >= NTDDI_VISTA)
3566 , REG_FLUSH_KEY_INFORMATION
, *PREG_FLUSH_KEY_INFORMATION
3570 typedef struct _REG_SET_VALUE_KEY_INFORMATION
{
3572 PUNICODE_STRING ValueName
;
3578 PVOID ObjectContext
;
3580 } REG_SET_VALUE_KEY_INFORMATION
, *PREG_SET_VALUE_KEY_INFORMATION
;
3582 typedef struct _REG_DELETE_VALUE_KEY_INFORMATION
{
3584 PUNICODE_STRING ValueName
;
3586 PVOID ObjectContext
;
3588 } REG_DELETE_VALUE_KEY_INFORMATION
, *PREG_DELETE_VALUE_KEY_INFORMATION
;
3590 typedef struct _REG_SET_INFORMATION_KEY_INFORMATION
{
3592 KEY_SET_INFORMATION_CLASS KeySetInformationClass
;
3593 PVOID KeySetInformation
;
3594 ULONG KeySetInformationLength
;
3596 PVOID ObjectContext
;
3598 } REG_SET_INFORMATION_KEY_INFORMATION
, *PREG_SET_INFORMATION_KEY_INFORMATION
;
3600 typedef struct _REG_ENUMERATE_KEY_INFORMATION
{
3603 KEY_INFORMATION_CLASS KeyInformationClass
;
3604 PVOID KeyInformation
;
3606 PULONG ResultLength
;
3608 PVOID ObjectContext
;
3610 } REG_ENUMERATE_KEY_INFORMATION
, *PREG_ENUMERATE_KEY_INFORMATION
;
3612 typedef struct _REG_ENUMERATE_VALUE_KEY_INFORMATION
{
3615 KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass
;
3616 PVOID KeyValueInformation
;
3618 PULONG ResultLength
;
3620 PVOID ObjectContext
;
3622 } REG_ENUMERATE_VALUE_KEY_INFORMATION
, *PREG_ENUMERATE_VALUE_KEY_INFORMATION
;
3624 typedef struct _REG_QUERY_KEY_INFORMATION
{
3626 KEY_INFORMATION_CLASS KeyInformationClass
;
3627 PVOID KeyInformation
;
3629 PULONG ResultLength
;
3631 PVOID ObjectContext
;
3633 } REG_QUERY_KEY_INFORMATION
, *PREG_QUERY_KEY_INFORMATION
;
3635 typedef struct _REG_QUERY_VALUE_KEY_INFORMATION
{
3637 PUNICODE_STRING ValueName
;
3638 KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass
;
3639 PVOID KeyValueInformation
;
3641 PULONG ResultLength
;
3643 PVOID ObjectContext
;
3645 } REG_QUERY_VALUE_KEY_INFORMATION
, *PREG_QUERY_VALUE_KEY_INFORMATION
;
3647 typedef struct _REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION
{
3649 PKEY_VALUE_ENTRY ValueEntries
;
3652 PULONG BufferLength
;
3653 PULONG RequiredBufferLength
;
3655 PVOID ObjectContext
;
3657 } REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION
, *PREG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION
;
3659 typedef struct _REG_RENAME_KEY_INFORMATION
{
3661 PUNICODE_STRING NewName
;
3663 PVOID ObjectContext
;
3665 } REG_RENAME_KEY_INFORMATION
, *PREG_RENAME_KEY_INFORMATION
;
3667 typedef struct _REG_CREATE_KEY_INFORMATION
{
3668 PUNICODE_STRING CompleteName
;
3671 ULONG CreateOptions
;
3672 PUNICODE_STRING Class
;
3673 PVOID SecurityDescriptor
;
3674 PVOID SecurityQualityOfService
;
3675 ACCESS_MASK DesiredAccess
;
3676 ACCESS_MASK GrantedAccess
;
3678 PVOID
*ResultObject
;
3680 PVOID RootObjectContext
;
3683 } REG_CREATE_KEY_INFORMATION
, REG_OPEN_KEY_INFORMATION
,*PREG_CREATE_KEY_INFORMATION
, *PREG_OPEN_KEY_INFORMATION
;
3685 typedef struct _REG_CREATE_KEY_INFORMATION_V1
{
3686 PUNICODE_STRING CompleteName
;
3690 PUNICODE_STRING Class
;
3691 PVOID SecurityDescriptor
;
3692 PVOID SecurityQualityOfService
;
3693 ACCESS_MASK DesiredAccess
;
3694 ACCESS_MASK GrantedAccess
;
3696 PVOID
*ResultObject
;
3698 PVOID RootObjectContext
;
3701 PUNICODE_STRING RemainingName
;
3704 KPROCESSOR_MODE CheckAccessMode
;
3705 } REG_CREATE_KEY_INFORMATION_V1
, REG_OPEN_KEY_INFORMATION_V1
,*PREG_CREATE_KEY_INFORMATION_V1
, *PREG_OPEN_KEY_INFORMATION_V1
;
3707 typedef struct _REG_PRE_CREATE_KEY_INFORMATION
{
3708 PUNICODE_STRING CompleteName
;
3709 } REG_PRE_CREATE_KEY_INFORMATION
, REG_PRE_OPEN_KEY_INFORMATION
,*PREG_PRE_CREATE_KEY_INFORMATION
, *PREG_PRE_OPEN_KEY_INFORMATION
;;
3711 typedef struct _REG_POST_CREATE_KEY_INFORMATION
{
3712 PUNICODE_STRING CompleteName
;
3715 } REG_POST_CREATE_KEY_INFORMATION
,REG_POST_OPEN_KEY_INFORMATION
, *PREG_POST_CREATE_KEY_INFORMATION
, *PREG_POST_OPEN_KEY_INFORMATION
;
3717 typedef struct _REG_POST_OPERATION_INFORMATION
{
3720 PVOID PreInformation
;
3721 NTSTATUS ReturnStatus
;
3723 PVOID ObjectContext
;
3725 } REG_POST_OPERATION_INFORMATION
,*PREG_POST_OPERATION_INFORMATION
;
3727 typedef struct _REG_KEY_HANDLE_CLOSE_INFORMATION
{
3730 PVOID ObjectContext
;
3732 } REG_KEY_HANDLE_CLOSE_INFORMATION
, *PREG_KEY_HANDLE_CLOSE_INFORMATION
;
3734 #if (NTDDI_VERSION >= NTDDI_VISTA)
3736 typedef struct _REG_LOAD_KEY_INFORMATION
{
3738 PUNICODE_STRING KeyName
;
3739 PUNICODE_STRING SourceFile
;
3741 PVOID TrustClassObject
;
3743 ACCESS_MASK DesiredAccess
;
3746 PVOID ObjectContext
;
3748 } REG_LOAD_KEY_INFORMATION
, *PREG_LOAD_KEY_INFORMATION
;
3750 typedef struct _REG_UNLOAD_KEY_INFORMATION
{
3754 PVOID ObjectContext
;
3756 } REG_UNLOAD_KEY_INFORMATION
, *PREG_UNLOAD_KEY_INFORMATION
;
3758 typedef struct _REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION
{
3760 PVOID ObjectContext
;
3762 } REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION
, *PREG_CALLBACK_CONTEXT_CLEANUP_INFORMATION
;
3764 typedef struct _REG_QUERY_KEY_SECURITY_INFORMATION
{
3766 PSECURITY_INFORMATION SecurityInformation
;
3767 PSECURITY_DESCRIPTOR SecurityDescriptor
;
3770 PVOID ObjectContext
;
3772 } REG_QUERY_KEY_SECURITY_INFORMATION
, *PREG_QUERY_KEY_SECURITY_INFORMATION
;
3774 typedef struct _REG_SET_KEY_SECURITY_INFORMATION
{
3776 PSECURITY_INFORMATION SecurityInformation
;
3777 PSECURITY_DESCRIPTOR SecurityDescriptor
;
3779 PVOID ObjectContext
;
3781 } REG_SET_KEY_SECURITY_INFORMATION
, *PREG_SET_KEY_SECURITY_INFORMATION
;
3783 typedef struct _REG_RESTORE_KEY_INFORMATION
{
3788 PVOID ObjectContext
;
3790 } REG_RESTORE_KEY_INFORMATION
, *PREG_RESTORE_KEY_INFORMATION
;
3792 typedef struct _REG_SAVE_KEY_INFORMATION
{
3797 PVOID ObjectContext
;
3799 } REG_SAVE_KEY_INFORMATION
, *PREG_SAVE_KEY_INFORMATION
;
3801 typedef struct _REG_REPLACE_KEY_INFORMATION
{
3803 PUNICODE_STRING OldFileName
;
3804 PUNICODE_STRING NewFileName
;
3806 PVOID ObjectContext
;
3808 } REG_REPLACE_KEY_INFORMATION
, *PREG_REPLACE_KEY_INFORMATION
;
3810 #endif /* NTDDI_VERSION >= NTDDI_VISTA */
3812 #define SERVICE_KERNEL_DRIVER 0x00000001
3813 #define SERVICE_FILE_SYSTEM_DRIVER 0x00000002
3814 #define SERVICE_ADAPTER 0x00000004
3815 #define SERVICE_RECOGNIZER_DRIVER 0x00000008
3817 #define SERVICE_DRIVER (SERVICE_KERNEL_DRIVER | \
3818 SERVICE_FILE_SYSTEM_DRIVER | \
3819 SERVICE_RECOGNIZER_DRIVER)
3821 #define SERVICE_WIN32_OWN_PROCESS 0x00000010
3822 #define SERVICE_WIN32_SHARE_PROCESS 0x00000020
3823 #define SERVICE_WIN32 (SERVICE_WIN32_OWN_PROCESS | \
3824 SERVICE_WIN32_SHARE_PROCESS)
3826 #define SERVICE_INTERACTIVE_PROCESS 0x00000100
3828 #define SERVICE_TYPE_ALL (SERVICE_WIN32 | \
3831 SERVICE_INTERACTIVE_PROCESS)
3833 /* Service Start Types */
3834 #define SERVICE_BOOT_START 0x00000000
3835 #define SERVICE_SYSTEM_START 0x00000001
3836 #define SERVICE_AUTO_START 0x00000002
3837 #define SERVICE_DEMAND_START 0x00000003
3838 #define SERVICE_DISABLED 0x00000004
3840 #define SERVICE_ERROR_IGNORE 0x00000000
3841 #define SERVICE_ERROR_NORMAL 0x00000001
3842 #define SERVICE_ERROR_SEVERE 0x00000002
3843 #define SERVICE_ERROR_CRITICAL 0x00000003
3845 typedef enum _CM_SERVICE_NODE_TYPE
{
3846 DriverType
= SERVICE_KERNEL_DRIVER
,
3847 FileSystemType
= SERVICE_FILE_SYSTEM_DRIVER
,
3848 Win32ServiceOwnProcess
= SERVICE_WIN32_OWN_PROCESS
,
3849 Win32ServiceShareProcess
= SERVICE_WIN32_SHARE_PROCESS
,
3850 AdapterType
= SERVICE_ADAPTER
,
3851 RecognizerType
= SERVICE_RECOGNIZER_DRIVER
3852 } SERVICE_NODE_TYPE
;
3854 typedef enum _CM_SERVICE_LOAD_TYPE
{
3855 BootLoad
= SERVICE_BOOT_START
,
3856 SystemLoad
= SERVICE_SYSTEM_START
,
3857 AutoLoad
= SERVICE_AUTO_START
,
3858 DemandLoad
= SERVICE_DEMAND_START
,
3859 DisableLoad
= SERVICE_DISABLED
3860 } SERVICE_LOAD_TYPE
;
3862 typedef enum _CM_ERROR_CONTROL_TYPE
{
3863 IgnoreError
= SERVICE_ERROR_IGNORE
,
3864 NormalError
= SERVICE_ERROR_NORMAL
,
3865 SevereError
= SERVICE_ERROR_SEVERE
,
3866 CriticalError
= SERVICE_ERROR_CRITICAL
3867 } SERVICE_ERROR_TYPE
;
3869 #define CM_SERVICE_NETWORK_BOOT_LOAD 0x00000001
3870 #define CM_SERVICE_VIRTUAL_DISK_BOOT_LOAD 0x00000002
3871 #define CM_SERVICE_USB_DISK_BOOT_LOAD 0x00000004
3873 #define CM_SERVICE_VALID_PROMOTION_MASK (CM_SERVICE_NETWORK_BOOT_LOAD | \
3874 CM_SERVICE_VIRTUAL_DISK_BOOT_LOAD | \
3875 CM_SERVICE_USB_DISK_BOOT_LOAD)
3877 /******************************************************************************
3878 * I/O Manager Types *
3879 ******************************************************************************/
3882 #define STATUS_CONTINUE_COMPLETION STATUS_SUCCESS
3884 #define CONNECT_FULLY_SPECIFIED 0x1
3885 #define CONNECT_LINE_BASED 0x2
3886 #define CONNECT_MESSAGE_BASED 0x3
3887 #define CONNECT_FULLY_SPECIFIED_GROUP 0x4
3888 #define CONNECT_CURRENT_VERSION 0x4
3890 #define POOL_COLD_ALLOCATION 256
3891 #define POOL_QUOTA_FAIL_INSTEAD_OF_RAISE 8
3892 #define POOL_RAISE_IF_ALLOCATION_FAILURE 16
3894 #define IO_TYPE_ADAPTER 1
3895 #define IO_TYPE_CONTROLLER 2
3896 #define IO_TYPE_DEVICE 3
3897 #define IO_TYPE_DRIVER 4
3898 #define IO_TYPE_FILE 5
3899 #define IO_TYPE_IRP 6
3900 #define IO_TYPE_MASTER_ADAPTER 7
3901 #define IO_TYPE_OPEN_PACKET 8
3902 #define IO_TYPE_TIMER 9
3903 #define IO_TYPE_VPB 10
3904 #define IO_TYPE_ERROR_LOG 11
3905 #define IO_TYPE_ERROR_MESSAGE 12
3906 #define IO_TYPE_DEVICE_OBJECT_EXTENSION 13
3908 #define IO_TYPE_CSQ_IRP_CONTEXT 1
3909 #define IO_TYPE_CSQ 2
3910 #define IO_TYPE_CSQ_EX 3
3912 /* IO_RESOURCE_DESCRIPTOR.Option */
3913 #define IO_RESOURCE_PREFERRED 0x01
3914 #define IO_RESOURCE_DEFAULT 0x02
3915 #define IO_RESOURCE_ALTERNATIVE 0x08
3917 #define FILE_DEVICE_BEEP 0x00000001
3918 #define FILE_DEVICE_CD_ROM 0x00000002
3919 #define FILE_DEVICE_CD_ROM_FILE_SYSTEM 0x00000003
3920 #define FILE_DEVICE_CONTROLLER 0x00000004
3921 #define FILE_DEVICE_DATALINK 0x00000005
3922 #define FILE_DEVICE_DFS 0x00000006
3923 #define FILE_DEVICE_DISK 0x00000007
3924 #define FILE_DEVICE_DISK_FILE_SYSTEM 0x00000008
3925 #define FILE_DEVICE_FILE_SYSTEM 0x00000009
3926 #define FILE_DEVICE_INPORT_PORT 0x0000000a
3927 #define FILE_DEVICE_KEYBOARD 0x0000000b
3928 #define FILE_DEVICE_MAILSLOT 0x0000000c
3929 #define FILE_DEVICE_MIDI_IN 0x0000000d
3930 #define FILE_DEVICE_MIDI_OUT 0x0000000e
3931 #define FILE_DEVICE_MOUSE 0x0000000f
3932 #define FILE_DEVICE_MULTI_UNC_PROVIDER 0x00000010
3933 #define FILE_DEVICE_NAMED_PIPE 0x00000011
3934 #define FILE_DEVICE_NETWORK 0x00000012
3935 #define FILE_DEVICE_NETWORK_BROWSER 0x00000013
3936 #define FILE_DEVICE_NETWORK_FILE_SYSTEM 0x00000014
3937 #define FILE_DEVICE_NULL 0x00000015
3938 #define FILE_DEVICE_PARALLEL_PORT 0x00000016
3939 #define FILE_DEVICE_PHYSICAL_NETCARD 0x00000017
3940 #define FILE_DEVICE_PRINTER 0x00000018
3941 #define FILE_DEVICE_SCANNER 0x00000019
3942 #define FILE_DEVICE_SERIAL_MOUSE_PORT 0x0000001a
3943 #define FILE_DEVICE_SERIAL_PORT 0x0000001b
3944 #define FILE_DEVICE_SCREEN 0x0000001c
3945 #define FILE_DEVICE_SOUND 0x0000001d
3946 #define FILE_DEVICE_STREAMS 0x0000001e
3947 #define FILE_DEVICE_TAPE 0x0000001f
3948 #define FILE_DEVICE_TAPE_FILE_SYSTEM 0x00000020
3949 #define FILE_DEVICE_TRANSPORT 0x00000021
3950 #define FILE_DEVICE_UNKNOWN 0x00000022
3951 #define FILE_DEVICE_VIDEO 0x00000023
3952 #define FILE_DEVICE_VIRTUAL_DISK 0x00000024
3953 #define FILE_DEVICE_WAVE_IN 0x00000025
3954 #define FILE_DEVICE_WAVE_OUT 0x00000026
3955 #define FILE_DEVICE_8042_PORT 0x00000027
3956 #define FILE_DEVICE_NETWORK_REDIRECTOR 0x00000028
3957 #define FILE_DEVICE_BATTERY 0x00000029
3958 #define FILE_DEVICE_BUS_EXTENDER 0x0000002a
3959 #define FILE_DEVICE_MODEM 0x0000002b
3960 #define FILE_DEVICE_VDM 0x0000002c
3961 #define FILE_DEVICE_MASS_STORAGE 0x0000002d
3962 #define FILE_DEVICE_SMB 0x0000002e
3963 #define FILE_DEVICE_KS 0x0000002f
3964 #define FILE_DEVICE_CHANGER 0x00000030
3965 #define FILE_DEVICE_SMARTCARD 0x00000031
3966 #define FILE_DEVICE_ACPI 0x00000032
3967 #define FILE_DEVICE_DVD 0x00000033
3968 #define FILE_DEVICE_FULLSCREEN_VIDEO 0x00000034
3969 #define FILE_DEVICE_DFS_FILE_SYSTEM 0x00000035
3970 #define FILE_DEVICE_DFS_VOLUME 0x00000036
3971 #define FILE_DEVICE_SERENUM 0x00000037
3972 #define FILE_DEVICE_TERMSRV 0x00000038
3973 #define FILE_DEVICE_KSEC 0x00000039
3974 #define FILE_DEVICE_FIPS 0x0000003A
3975 #define FILE_DEVICE_INFINIBAND 0x0000003B
3976 #define FILE_DEVICE_VMBUS 0x0000003E
3977 #define FILE_DEVICE_CRYPT_PROVIDER 0x0000003F
3978 #define FILE_DEVICE_WPD 0x00000040
3979 #define FILE_DEVICE_BLUETOOTH 0x00000041
3980 #define FILE_DEVICE_MT_COMPOSITE 0x00000042
3981 #define FILE_DEVICE_MT_TRANSPORT 0x00000043
3982 #define FILE_DEVICE_BIOMETRIC 0x00000044
3983 #define FILE_DEVICE_PMI 0x00000045
3985 #if defined(NT_PROCESSOR_GROUPS)
3987 typedef USHORT IRQ_DEVICE_POLICY
, *PIRQ_DEVICE_POLICY
;
3989 typedef enum _IRQ_DEVICE_POLICY_USHORT
{
3990 IrqPolicyMachineDefault
= 0,
3991 IrqPolicyAllCloseProcessors
= 1,
3992 IrqPolicyOneCloseProcessor
= 2,
3993 IrqPolicyAllProcessorsInMachine
= 3,
3994 IrqPolicyAllProcessorsInGroup
= 3,
3995 IrqPolicySpecifiedProcessors
= 4,
3996 IrqPolicySpreadMessagesAcrossAllProcessors
= 5};
3998 #else /* defined(NT_PROCESSOR_GROUPS) */
4000 typedef enum _IRQ_DEVICE_POLICY
{
4001 IrqPolicyMachineDefault
= 0,
4002 IrqPolicyAllCloseProcessors
,
4003 IrqPolicyOneCloseProcessor
,
4004 IrqPolicyAllProcessorsInMachine
,
4005 IrqPolicySpecifiedProcessors
,
4006 IrqPolicySpreadMessagesAcrossAllProcessors
4007 } IRQ_DEVICE_POLICY
, *PIRQ_DEVICE_POLICY
;
4011 typedef enum _IRQ_PRIORITY
{
4012 IrqPriorityUndefined
= 0,
4016 } IRQ_PRIORITY
, *PIRQ_PRIORITY
;
4018 typedef enum _IRQ_GROUP_POLICY
{
4019 GroupAffinityAllGroupZero
= 0,
4020 GroupAffinityDontCare
4021 } IRQ_GROUP_POLICY
, *PIRQ_GROUP_POLICY
;
4023 #define MAXIMUM_VOLUME_LABEL_LENGTH (32 * sizeof(WCHAR))
4025 typedef struct _OBJECT_HANDLE_INFORMATION
{
4026 ULONG HandleAttributes
;
4027 ACCESS_MASK GrantedAccess
;
4028 } OBJECT_HANDLE_INFORMATION
, *POBJECT_HANDLE_INFORMATION
;
4030 typedef struct _CLIENT_ID
{
4031 HANDLE UniqueProcess
;
4032 HANDLE UniqueThread
;
4033 } CLIENT_ID
, *PCLIENT_ID
;
4035 typedef struct _VPB
{
4039 USHORT VolumeLabelLength
;
4040 struct _DEVICE_OBJECT
*DeviceObject
;
4041 struct _DEVICE_OBJECT
*RealDevice
;
4043 ULONG ReferenceCount
;
4044 WCHAR VolumeLabel
[MAXIMUM_VOLUME_LABEL_LENGTH
/ sizeof(WCHAR
)];
4047 typedef enum _IO_ALLOCATION_ACTION
{
4050 DeallocateObjectKeepRegisters
4051 } IO_ALLOCATION_ACTION
, *PIO_ALLOCATION_ACTION
;
4053 _Function_class_(DRIVER_CONTROL
)
4054 _IRQL_requires_same_
4055 typedef IO_ALLOCATION_ACTION
4056 (NTAPI DRIVER_CONTROL
)(
4057 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
4058 _Inout_
struct _IRP
*Irp
,
4059 _In_ PVOID MapRegisterBase
,
4060 _In_ PVOID Context
);
4061 typedef DRIVER_CONTROL
*PDRIVER_CONTROL
;
4063 typedef struct _WAIT_CONTEXT_BLOCK
{
4064 KDEVICE_QUEUE_ENTRY WaitQueueEntry
;
4065 PDRIVER_CONTROL DeviceRoutine
;
4066 PVOID DeviceContext
;
4067 ULONG NumberOfMapRegisters
;
4070 PKDPC BufferChainingDpc
;
4071 } WAIT_CONTEXT_BLOCK
, *PWAIT_CONTEXT_BLOCK
;
4073 /* DEVICE_OBJECT.Flags */
4074 #define DO_VERIFY_VOLUME 0x00000002
4075 #define DO_BUFFERED_IO 0x00000004
4076 #define DO_EXCLUSIVE 0x00000008
4077 #define DO_DIRECT_IO 0x00000010
4078 #define DO_MAP_IO_BUFFER 0x00000020
4079 #define DO_DEVICE_INITIALIZING 0x00000080
4080 #define DO_SHUTDOWN_REGISTERED 0x00000800
4081 #define DO_BUS_ENUMERATED_DEVICE 0x00001000
4082 #define DO_POWER_PAGABLE 0x00002000
4083 #define DO_POWER_INRUSH 0x00004000
4085 /* DEVICE_OBJECT.Characteristics */
4086 #define FILE_REMOVABLE_MEDIA 0x00000001
4087 #define FILE_READ_ONLY_DEVICE 0x00000002
4088 #define FILE_FLOPPY_DISKETTE 0x00000004
4089 #define FILE_WRITE_ONCE_MEDIA 0x00000008
4090 #define FILE_REMOTE_DEVICE 0x00000010
4091 #define FILE_DEVICE_IS_MOUNTED 0x00000020
4092 #define FILE_VIRTUAL_VOLUME 0x00000040
4093 #define FILE_AUTOGENERATED_DEVICE_NAME 0x00000080
4094 #define FILE_DEVICE_SECURE_OPEN 0x00000100
4095 #define FILE_CHARACTERISTIC_PNP_DEVICE 0x00000800
4096 #define FILE_CHARACTERISTIC_TS_DEVICE 0x00001000
4097 #define FILE_CHARACTERISTIC_WEBDAV_DEVICE 0x00002000
4099 /* DEVICE_OBJECT.AlignmentRequirement */
4100 #define FILE_BYTE_ALIGNMENT 0x00000000
4101 #define FILE_WORD_ALIGNMENT 0x00000001
4102 #define FILE_LONG_ALIGNMENT 0x00000003
4103 #define FILE_QUAD_ALIGNMENT 0x00000007
4104 #define FILE_OCTA_ALIGNMENT 0x0000000f
4105 #define FILE_32_BYTE_ALIGNMENT 0x0000001f
4106 #define FILE_64_BYTE_ALIGNMENT 0x0000003f
4107 #define FILE_128_BYTE_ALIGNMENT 0x0000007f
4108 #define FILE_256_BYTE_ALIGNMENT 0x000000ff
4109 #define FILE_512_BYTE_ALIGNMENT 0x000001ff
4111 /* DEVICE_OBJECT.DeviceType */
4112 #define DEVICE_TYPE ULONG
4114 typedef struct DECLSPEC_ALIGN(MEMORY_ALLOCATION_ALIGNMENT
) _DEVICE_OBJECT
{
4117 LONG ReferenceCount
;
4118 struct _DRIVER_OBJECT
*DriverObject
;
4119 struct _DEVICE_OBJECT
*NextDevice
;
4120 struct _DEVICE_OBJECT
*AttachedDevice
;
4121 struct _IRP
*CurrentIrp
;
4124 ULONG Characteristics
;
4126 PVOID DeviceExtension
;
4127 DEVICE_TYPE DeviceType
;
4130 LIST_ENTRY ListEntry
;
4131 WAIT_CONTEXT_BLOCK Wcb
;
4133 ULONG AlignmentRequirement
;
4134 KDEVICE_QUEUE DeviceQueue
;
4136 ULONG ActiveThreadCount
;
4137 PSECURITY_DESCRIPTOR SecurityDescriptor
;
4141 struct _DEVOBJ_EXTENSION
*DeviceObjectExtension
;
4143 } DEVICE_OBJECT
, *PDEVICE_OBJECT
;
4145 typedef enum _IO_SESSION_STATE
{
4146 IoSessionStateCreated
= 1,
4147 IoSessionStateInitialized
,
4148 IoSessionStateConnected
,
4149 IoSessionStateDisconnected
,
4150 IoSessionStateDisconnectedLoggedOn
,
4151 IoSessionStateLoggedOn
,
4152 IoSessionStateLoggedOff
,
4153 IoSessionStateTerminated
,
4155 } IO_SESSION_STATE
, *PIO_SESSION_STATE
;
4157 typedef enum _IO_COMPLETION_ROUTINE_RESULT
{
4158 ContinueCompletion
= STATUS_CONTINUE_COMPLETION
,
4159 StopCompletion
= STATUS_MORE_PROCESSING_REQUIRED
4160 } IO_COMPLETION_ROUTINE_RESULT
, *PIO_COMPLETION_ROUTINE_RESULT
;
4162 typedef struct _IO_INTERRUPT_MESSAGE_INFO_ENTRY
{
4163 PHYSICAL_ADDRESS MessageAddress
;
4164 KAFFINITY TargetProcessorSet
;
4165 PKINTERRUPT InterruptObject
;
4169 KINTERRUPT_MODE Mode
;
4170 KINTERRUPT_POLARITY Polarity
;
4171 } IO_INTERRUPT_MESSAGE_INFO_ENTRY
, *PIO_INTERRUPT_MESSAGE_INFO_ENTRY
;
4173 typedef struct _IO_INTERRUPT_MESSAGE_INFO
{
4176 IO_INTERRUPT_MESSAGE_INFO_ENTRY MessageInfo
[1];
4177 } IO_INTERRUPT_MESSAGE_INFO
, *PIO_INTERRUPT_MESSAGE_INFO
;
4179 typedef struct _IO_CONNECT_INTERRUPT_FULLY_SPECIFIED_PARAMETERS
{
4180 _In_ PDEVICE_OBJECT PhysicalDeviceObject
;
4181 _Out_ PKINTERRUPT
*InterruptObject
;
4182 _In_ PKSERVICE_ROUTINE ServiceRoutine
;
4183 _In_ PVOID ServiceContext
;
4184 _In_opt_ PKSPIN_LOCK SpinLock
;
4185 _In_ KIRQL SynchronizeIrql
;
4186 _In_ BOOLEAN FloatingSave
;
4187 _In_ BOOLEAN ShareVector
;
4190 _In_ KINTERRUPT_MODE InterruptMode
;
4191 _In_ KAFFINITY ProcessorEnableMask
;
4193 } IO_CONNECT_INTERRUPT_FULLY_SPECIFIED_PARAMETERS
, *PIO_CONNECT_INTERRUPT_FULLY_SPECIFIED_PARAMETERS
;
4195 typedef struct _IO_CONNECT_INTERRUPT_LINE_BASED_PARAMETERS
{
4196 _In_ PDEVICE_OBJECT PhysicalDeviceObject
;
4197 _Out_ PKINTERRUPT
*InterruptObject
;
4198 _In_ PKSERVICE_ROUTINE ServiceRoutine
;
4199 _In_ PVOID ServiceContext
;
4200 _In_opt_ PKSPIN_LOCK SpinLock
;
4201 _In_opt_ KIRQL SynchronizeIrql
;
4202 _In_ BOOLEAN FloatingSave
;
4203 } IO_CONNECT_INTERRUPT_LINE_BASED_PARAMETERS
, *PIO_CONNECT_INTERRUPT_LINE_BASED_PARAMETERS
;
4205 typedef struct _IO_CONNECT_INTERRUPT_MESSAGE_BASED_PARAMETERS
{
4206 _In_ PDEVICE_OBJECT PhysicalDeviceObject
;
4208 _Out_ PVOID
*Generic
;
4209 _Out_ PIO_INTERRUPT_MESSAGE_INFO
*InterruptMessageTable
;
4210 _Out_ PKINTERRUPT
*InterruptObject
;
4211 } ConnectionContext
;
4212 _In_ PKMESSAGE_SERVICE_ROUTINE MessageServiceRoutine
;
4213 _In_ PVOID ServiceContext
;
4214 _In_opt_ PKSPIN_LOCK SpinLock
;
4215 _In_opt_ KIRQL SynchronizeIrql
;
4216 _In_ BOOLEAN FloatingSave
;
4217 _In_opt_ PKSERVICE_ROUTINE FallBackServiceRoutine
;
4218 } IO_CONNECT_INTERRUPT_MESSAGE_BASED_PARAMETERS
, *PIO_CONNECT_INTERRUPT_MESSAGE_BASED_PARAMETERS
;
4220 typedef struct _IO_CONNECT_INTERRUPT_PARAMETERS
{
4221 _Inout_ ULONG Version
;
4222 _ANONYMOUS_UNION
union {
4223 IO_CONNECT_INTERRUPT_FULLY_SPECIFIED_PARAMETERS FullySpecified
;
4224 IO_CONNECT_INTERRUPT_LINE_BASED_PARAMETERS LineBased
;
4225 IO_CONNECT_INTERRUPT_MESSAGE_BASED_PARAMETERS MessageBased
;
4227 } IO_CONNECT_INTERRUPT_PARAMETERS
, *PIO_CONNECT_INTERRUPT_PARAMETERS
;
4229 typedef struct _IO_DISCONNECT_INTERRUPT_PARAMETERS
{
4233 _In_ PKINTERRUPT InterruptObject
;
4234 _In_ PIO_INTERRUPT_MESSAGE_INFO InterruptMessageTable
;
4235 } ConnectionContext
;
4236 } IO_DISCONNECT_INTERRUPT_PARAMETERS
, *PIO_DISCONNECT_INTERRUPT_PARAMETERS
;
4238 typedef enum _IO_ACCESS_TYPE
{
4244 typedef enum _IO_ACCESS_MODE
{
4249 typedef enum _IO_CONTAINER_NOTIFICATION_CLASS
{
4250 IoSessionStateNotification
,
4251 IoMaxContainerNotificationClass
4252 } IO_CONTAINER_NOTIFICATION_CLASS
;
4254 typedef struct _IO_SESSION_STATE_NOTIFICATION
{
4260 } IO_SESSION_STATE_NOTIFICATION
, *PIO_SESSION_STATE_NOTIFICATION
;
4262 typedef enum _IO_CONTAINER_INFORMATION_CLASS
{
4263 IoSessionStateInformation
,
4264 IoMaxContainerInformationClass
4265 } IO_CONTAINER_INFORMATION_CLASS
;
4267 typedef struct _IO_SESSION_STATE_INFORMATION
{
4269 IO_SESSION_STATE SessionState
;
4270 BOOLEAN LocalSession
;
4271 } IO_SESSION_STATE_INFORMATION
, *PIO_SESSION_STATE_INFORMATION
;
4273 #if (NTDDI_VERSION >= NTDDI_WIN7)
4276 (NTAPI
*PIO_CONTAINER_NOTIFICATION_FUNCTION
)(
4280 (NTAPI IO_SESSION_NOTIFICATION_FUNCTION
)(
4281 _In_ PVOID SessionObject
,
4282 _In_ PVOID IoObject
,
4285 _In_reads_bytes_opt_(PayloadLength
) PVOID NotificationPayload
,
4286 _In_ ULONG PayloadLength
);
4288 typedef IO_SESSION_NOTIFICATION_FUNCTION
*PIO_SESSION_NOTIFICATION_FUNCTION
;
4292 typedef struct _IO_REMOVE_LOCK_TRACKING_BLOCK
* PIO_REMOVE_LOCK_TRACKING_BLOCK
;
4294 typedef struct _IO_REMOVE_LOCK_COMMON_BLOCK
{
4296 BOOLEAN Reserved
[3];
4297 volatile LONG IoCount
;
4299 } IO_REMOVE_LOCK_COMMON_BLOCK
;
4301 typedef struct _IO_REMOVE_LOCK_DBG_BLOCK
{
4304 LONGLONG MaxLockedTicks
;
4306 LIST_ENTRY LockList
;
4308 volatile LONG LowMemoryCount
;
4311 PIO_REMOVE_LOCK_TRACKING_BLOCK Blocks
;
4312 } IO_REMOVE_LOCK_DBG_BLOCK
;
4314 typedef struct _IO_REMOVE_LOCK
{
4315 IO_REMOVE_LOCK_COMMON_BLOCK Common
;
4317 IO_REMOVE_LOCK_DBG_BLOCK Dbg
;
4319 } IO_REMOVE_LOCK
, *PIO_REMOVE_LOCK
;
4321 typedef struct _IO_WORKITEM
*PIO_WORKITEM
;
4323 _Function_class_(IO_WORKITEM_ROUTINE
)
4324 _IRQL_requires_(PASSIVE_LEVEL
)
4325 _IRQL_requires_same_
4327 (NTAPI IO_WORKITEM_ROUTINE
)(
4328 _In_ PDEVICE_OBJECT DeviceObject
,
4329 _In_opt_ PVOID Context
);
4330 typedef IO_WORKITEM_ROUTINE
*PIO_WORKITEM_ROUTINE
;
4333 (NTAPI IO_WORKITEM_ROUTINE_EX
)(
4334 _In_ PVOID IoObject
,
4335 _In_opt_ PVOID Context
,
4336 _In_ PIO_WORKITEM IoWorkItem
);
4337 typedef IO_WORKITEM_ROUTINE_EX
*PIO_WORKITEM_ROUTINE_EX
;
4339 typedef struct _SHARE_ACCESS
{
4347 } SHARE_ACCESS
, *PSHARE_ACCESS
;
4349 /* While MS WDK uses inheritance in C++, we cannot do this with gcc, as
4350 inheritance, even from a struct renders the type non-POD. So we use
4352 #define PCI_COMMON_HEADER_LAYOUT \
4361 UCHAR CacheLineSize; \
4362 UCHAR LatencyTimer; \
4366 struct _PCI_HEADER_TYPE_0 { \
4367 ULONG BaseAddresses[PCI_TYPE0_ADDRESSES]; \
4369 USHORT SubVendorID; \
4370 USHORT SubSystemID; \
4371 ULONG ROMBaseAddress; \
4372 UCHAR CapabilitiesPtr; \
4373 UCHAR Reserved1[3]; \
4375 UCHAR InterruptLine; \
4376 UCHAR InterruptPin; \
4377 UCHAR MinimumGrant; \
4378 UCHAR MaximumLatency; \
4380 struct _PCI_HEADER_TYPE_1 { \
4381 ULONG BaseAddresses[PCI_TYPE1_ADDRESSES]; \
4383 UCHAR SecondaryBus; \
4384 UCHAR SubordinateBus; \
4385 UCHAR SecondaryLatency; \
4388 USHORT SecondaryStatus; \
4389 USHORT MemoryBase; \
4390 USHORT MemoryLimit; \
4391 USHORT PrefetchBase; \
4392 USHORT PrefetchLimit; \
4393 ULONG PrefetchBaseUpper32; \
4394 ULONG PrefetchLimitUpper32; \
4395 USHORT IOBaseUpper16; \
4396 USHORT IOLimitUpper16; \
4397 UCHAR CapabilitiesPtr; \
4398 UCHAR Reserved1[3]; \
4399 ULONG ROMBaseAddress; \
4400 UCHAR InterruptLine; \
4401 UCHAR InterruptPin; \
4402 USHORT BridgeControl; \
4404 struct _PCI_HEADER_TYPE_2 { \
4405 ULONG SocketRegistersBaseAddress; \
4406 UCHAR CapabilitiesPtr; \
4408 USHORT SecondaryStatus; \
4410 UCHAR SecondaryBus; \
4411 UCHAR SubordinateBus; \
4412 UCHAR SecondaryLatency; \
4416 } Range[PCI_TYPE2_ADDRESSES-1]; \
4417 UCHAR InterruptLine; \
4418 UCHAR InterruptPin; \
4419 USHORT BridgeControl; \
4423 typedef enum _CREATE_FILE_TYPE
{
4425 CreateFileTypeNamedPipe
,
4426 CreateFileTypeMailslot
4429 #define IO_FORCE_ACCESS_CHECK 0x001
4430 #define IO_NO_PARAMETER_CHECKING 0x100
4432 #define IO_REPARSE 0x0
4433 #define IO_REMOUNT 0x1
4435 typedef struct _IO_STATUS_BLOCK
{
4436 _ANONYMOUS_UNION
union {
4440 ULONG_PTR Information
;
4441 } IO_STATUS_BLOCK
, *PIO_STATUS_BLOCK
;
4444 typedef struct _IO_STATUS_BLOCK32
{
4447 } IO_STATUS_BLOCK32
, *PIO_STATUS_BLOCK32
;
4451 (NTAPI
*PIO_APC_ROUTINE
)(
4452 _In_ PVOID ApcContext
,
4453 _In_ PIO_STATUS_BLOCK IoStatusBlock
,
4454 _In_ ULONG Reserved
);
4456 #define PIO_APC_ROUTINE_DEFINED
4458 typedef enum _IO_SESSION_EVENT
{
4459 IoSessionEventIgnore
= 0,
4460 IoSessionEventCreated
,
4461 IoSessionEventTerminated
,
4462 IoSessionEventConnected
,
4463 IoSessionEventDisconnected
,
4464 IoSessionEventLogon
,
4465 IoSessionEventLogoff
,
4467 } IO_SESSION_EVENT
, *PIO_SESSION_EVENT
;
4469 #define IO_SESSION_STATE_ALL_EVENTS 0xffffffff
4470 #define IO_SESSION_STATE_CREATION_EVENT 0x00000001
4471 #define IO_SESSION_STATE_TERMINATION_EVENT 0x00000002
4472 #define IO_SESSION_STATE_CONNECT_EVENT 0x00000004
4473 #define IO_SESSION_STATE_DISCONNECT_EVENT 0x00000008
4474 #define IO_SESSION_STATE_LOGON_EVENT 0x00000010
4475 #define IO_SESSION_STATE_LOGOFF_EVENT 0x00000020
4477 #define IO_SESSION_STATE_VALID_EVENT_MASK 0x0000003f
4479 #define IO_SESSION_MAX_PAYLOAD_SIZE 256L
4481 typedef struct _IO_SESSION_CONNECT_INFO
{
4483 BOOLEAN LocalSession
;
4484 } IO_SESSION_CONNECT_INFO
, *PIO_SESSION_CONNECT_INFO
;
4486 #define EVENT_INCREMENT 1
4487 #define IO_NO_INCREMENT 0
4488 #define IO_CD_ROM_INCREMENT 1
4489 #define IO_DISK_INCREMENT 1
4490 #define IO_KEYBOARD_INCREMENT 6
4491 #define IO_MAILSLOT_INCREMENT 2
4492 #define IO_MOUSE_INCREMENT 6
4493 #define IO_NAMED_PIPE_INCREMENT 2
4494 #define IO_NETWORK_INCREMENT 2
4495 #define IO_PARALLEL_INCREMENT 1
4496 #define IO_SERIAL_INCREMENT 2
4497 #define IO_SOUND_INCREMENT 8
4498 #define IO_VIDEO_INCREMENT 1
4499 #define SEMAPHORE_INCREMENT 1
4501 #define MM_MAXIMUM_DISK_IO_SIZE (0x10000)
4503 typedef struct _BOOTDISK_INFORMATION
{
4504 LONGLONG BootPartitionOffset
;
4505 LONGLONG SystemPartitionOffset
;
4506 ULONG BootDeviceSignature
;
4507 ULONG SystemDeviceSignature
;
4508 } BOOTDISK_INFORMATION
, *PBOOTDISK_INFORMATION
;
4510 typedef struct _BOOTDISK_INFORMATION_EX
{
4511 LONGLONG BootPartitionOffset
;
4512 LONGLONG SystemPartitionOffset
;
4513 ULONG BootDeviceSignature
;
4514 ULONG SystemDeviceSignature
;
4515 GUID BootDeviceGuid
;
4516 GUID SystemDeviceGuid
;
4517 BOOLEAN BootDeviceIsGpt
;
4518 BOOLEAN SystemDeviceIsGpt
;
4519 } BOOTDISK_INFORMATION_EX
, *PBOOTDISK_INFORMATION_EX
;
4521 #if (NTDDI_VERSION >= NTDDI_WIN7)
4523 typedef struct _LOADER_PARTITION_INFORMATION_EX
{
4524 ULONG PartitionStyle
;
4525 ULONG PartitionNumber
;
4526 _ANONYMOUS_UNION
union {
4531 } LOADER_PARTITION_INFORMATION_EX
, *PLOADER_PARTITION_INFORMATION_EX
;
4533 typedef struct _BOOTDISK_INFORMATION_LITE
{
4534 ULONG NumberEntries
;
4535 LOADER_PARTITION_INFORMATION_EX Entries
[1];
4536 } BOOTDISK_INFORMATION_LITE
, *PBOOTDISK_INFORMATION_LITE
;
4540 #if (NTDDI_VERSION >= NTDDI_VISTA)
4541 typedef struct _BOOTDISK_INFORMATION_LITE
{
4542 ULONG BootDeviceSignature
;
4543 ULONG SystemDeviceSignature
;
4544 GUID BootDeviceGuid
;
4545 GUID SystemDeviceGuid
;
4546 BOOLEAN BootDeviceIsGpt
;
4547 BOOLEAN SystemDeviceIsGpt
;
4548 } BOOTDISK_INFORMATION_LITE
, *PBOOTDISK_INFORMATION_LITE
;
4549 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
4551 #endif /* (NTDDI_VERSION >= NTDDI_WIN7) */
4553 #include <pshpack1.h>
4555 typedef struct _EISA_MEMORY_TYPE
{
4562 UCHAR MoreEntries
:1;
4563 } EISA_MEMORY_TYPE
, *PEISA_MEMORY_TYPE
;
4565 typedef struct _EISA_MEMORY_CONFIGURATION
{
4566 EISA_MEMORY_TYPE ConfigurationByte
;
4568 USHORT AddressLowWord
;
4569 UCHAR AddressHighByte
;
4571 } EISA_MEMORY_CONFIGURATION
, *PEISA_MEMORY_CONFIGURATION
;
4573 typedef struct _EISA_IRQ_DESCRIPTOR
{
4576 UCHAR LevelTriggered
:1;
4578 UCHAR MoreEntries
:1;
4579 } EISA_IRQ_DESCRIPTOR
, *PEISA_IRQ_DESCRIPTOR
;
4581 typedef struct _EISA_IRQ_CONFIGURATION
{
4582 EISA_IRQ_DESCRIPTOR ConfigurationByte
;
4584 } EISA_IRQ_CONFIGURATION
, *PEISA_IRQ_CONFIGURATION
;
4586 typedef struct _DMA_CONFIGURATION_BYTE0
{
4590 UCHAR MoreEntries
:1;
4591 } DMA_CONFIGURATION_BYTE0
;
4593 typedef struct _DMA_CONFIGURATION_BYTE1
{
4595 UCHAR TransferSize
:2;
4598 } DMA_CONFIGURATION_BYTE1
;
4600 typedef struct _EISA_DMA_CONFIGURATION
{
4601 DMA_CONFIGURATION_BYTE0 ConfigurationByte0
;
4602 DMA_CONFIGURATION_BYTE1 ConfigurationByte1
;
4603 } EISA_DMA_CONFIGURATION
, *PEISA_DMA_CONFIGURATION
;
4605 typedef struct _EISA_PORT_DESCRIPTOR
{
4606 UCHAR NumberPorts
:5;
4609 UCHAR MoreEntries
:1;
4610 } EISA_PORT_DESCRIPTOR
, *PEISA_PORT_DESCRIPTOR
;
4612 typedef struct _EISA_PORT_CONFIGURATION
{
4613 EISA_PORT_DESCRIPTOR Configuration
;
4615 } EISA_PORT_CONFIGURATION
, *PEISA_PORT_CONFIGURATION
;
4617 typedef struct _CM_EISA_SLOT_INFORMATION
{
4620 UCHAR MajorRevision
;
4621 UCHAR MinorRevision
;
4623 UCHAR NumberFunctions
;
4624 UCHAR FunctionInformation
;
4626 } CM_EISA_SLOT_INFORMATION
, *PCM_EISA_SLOT_INFORMATION
;
4628 typedef struct _CM_EISA_FUNCTION_INFORMATION
{
4632 UCHAR MinorRevision
;
4633 UCHAR MajorRevision
;
4634 UCHAR Selections
[26];
4635 UCHAR FunctionFlags
;
4636 UCHAR TypeString
[80];
4637 EISA_MEMORY_CONFIGURATION EisaMemory
[9];
4638 EISA_IRQ_CONFIGURATION EisaIrq
[7];
4639 EISA_DMA_CONFIGURATION EisaDma
[4];
4640 EISA_PORT_CONFIGURATION EisaPort
[20];
4641 UCHAR InitializationData
[60];
4642 } CM_EISA_FUNCTION_INFORMATION
, *PCM_EISA_FUNCTION_INFORMATION
;
4644 #include <poppack.h>
4646 /* CM_EISA_FUNCTION_INFORMATION.FunctionFlags */
4648 #define EISA_FUNCTION_ENABLED 0x80
4649 #define EISA_FREE_FORM_DATA 0x40
4650 #define EISA_HAS_PORT_INIT_ENTRY 0x20
4651 #define EISA_HAS_PORT_RANGE 0x10
4652 #define EISA_HAS_DMA_ENTRY 0x08
4653 #define EISA_HAS_IRQ_ENTRY 0x04
4654 #define EISA_HAS_MEMORY_ENTRY 0x02
4655 #define EISA_HAS_TYPE_ENTRY 0x01
4656 #define EISA_HAS_INFORMATION \
4657 (EISA_HAS_PORT_RANGE + EISA_HAS_DMA_ENTRY + EISA_HAS_IRQ_ENTRY \
4658 + EISA_HAS_MEMORY_ENTRY + EISA_HAS_TYPE_ENTRY)
4660 #define EISA_MORE_ENTRIES 0x80
4661 #define EISA_SYSTEM_MEMORY 0x00
4662 #define EISA_MEMORY_TYPE_RAM 0x01
4664 /* CM_EISA_SLOT_INFORMATION.ReturnCode */
4666 #define EISA_INVALID_SLOT 0x80
4667 #define EISA_INVALID_FUNCTION 0x81
4668 #define EISA_INVALID_CONFIGURATION 0x82
4669 #define EISA_EMPTY_SLOT 0x83
4670 #define EISA_INVALID_BIOS_CALL 0x86
4673 ** Plug and Play structures
4677 (NTAPI
*PINTERFACE_REFERENCE
)(
4681 (NTAPI
*PINTERFACE_DEREFERENCE
)(
4684 _Function_class_(TRANSLATE_BUS_ADDRESS
)
4685 _IRQL_requires_same_
4687 (NTAPI TRANSLATE_BUS_ADDRESS
)(
4688 _Inout_opt_ PVOID Context
,
4689 _In_ PHYSICAL_ADDRESS BusAddress
,
4691 _Out_ PULONG AddressSpace
,
4692 _Out_ PPHYSICAL_ADDRESS TranslatedAddress
);
4693 typedef TRANSLATE_BUS_ADDRESS
*PTRANSLATE_BUS_ADDRESS
;
4695 _Function_class_(GET_DMA_ADAPTER
)
4696 _IRQL_requires_same_
4697 typedef struct _DMA_ADAPTER
*
4698 (NTAPI GET_DMA_ADAPTER
)(
4699 _Inout_opt_ PVOID Context
,
4700 _In_
struct _DEVICE_DESCRIPTION
*DeviceDescriptor
,
4701 _Out_ PULONG NumberOfMapRegisters
);
4702 typedef GET_DMA_ADAPTER
*PGET_DMA_ADAPTER
;
4704 _Function_class_(GET_SET_DEVICE_DATA
)
4705 _IRQL_requires_same_
4707 (NTAPI GET_SET_DEVICE_DATA
)(
4708 _Inout_opt_ PVOID Context
,
4709 _In_ ULONG DataType
,
4710 _Inout_updates_bytes_(Length
) PVOID Buffer
,
4713 typedef GET_SET_DEVICE_DATA
*PGET_SET_DEVICE_DATA
;
4715 typedef enum _DEVICE_INSTALL_STATE
{
4716 InstallStateInstalled
,
4717 InstallStateNeedsReinstall
,
4718 InstallStateFailedInstall
,
4719 InstallStateFinishInstall
4720 } DEVICE_INSTALL_STATE
, *PDEVICE_INSTALL_STATE
;
4722 typedef struct _LEGACY_BUS_INFORMATION
{
4724 INTERFACE_TYPE LegacyBusType
;
4726 } LEGACY_BUS_INFORMATION
, *PLEGACY_BUS_INFORMATION
;
4728 typedef enum _DEVICE_REMOVAL_POLICY
{
4729 RemovalPolicyExpectNoRemoval
= 1,
4730 RemovalPolicyExpectOrderlyRemoval
= 2,
4731 RemovalPolicyExpectSurpriseRemoval
= 3
4732 } DEVICE_REMOVAL_POLICY
, *PDEVICE_REMOVAL_POLICY
;
4735 (NTAPI
*PREENUMERATE_SELF
)(
4736 _In_ PVOID Context
);
4738 typedef struct _REENUMERATE_SELF_INTERFACE_STANDARD
{
4742 PINTERFACE_REFERENCE InterfaceReference
;
4743 PINTERFACE_DEREFERENCE InterfaceDereference
;
4744 PREENUMERATE_SELF SurpriseRemoveAndReenumerateSelf
;
4745 } REENUMERATE_SELF_INTERFACE_STANDARD
, *PREENUMERATE_SELF_INTERFACE_STANDARD
;
4748 (NTAPI
*PIO_DEVICE_EJECT_CALLBACK
)(
4749 _In_ NTSTATUS Status
,
4750 _Inout_opt_ PVOID Context
);
4752 #define PCI_DEVICE_PRESENT_INTERFACE_VERSION 1
4754 /* PCI_DEVICE_PRESENCE_PARAMETERS.Flags */
4755 #define PCI_USE_SUBSYSTEM_IDS 0x00000001
4756 #define PCI_USE_REVISION 0x00000002
4757 #define PCI_USE_VENDEV_IDS 0x00000004
4758 #define PCI_USE_CLASS_SUBCLASS 0x00000008
4759 #define PCI_USE_PROGIF 0x00000010
4760 #define PCI_USE_LOCAL_BUS 0x00000020
4761 #define PCI_USE_LOCAL_DEVICE 0x00000040
4763 typedef struct _PCI_DEVICE_PRESENCE_PARAMETERS
{
4774 } PCI_DEVICE_PRESENCE_PARAMETERS
, *PPCI_DEVICE_PRESENCE_PARAMETERS
;
4776 _IRQL_requires_max_(PASSIVE_LEVEL
)
4777 _Must_inspect_result_
4779 (NTAPI PCI_IS_DEVICE_PRESENT
)(
4780 _In_ USHORT VendorID
,
4781 _In_ USHORT DeviceID
,
4782 _In_ UCHAR RevisionID
,
4783 _In_ USHORT SubVendorID
,
4784 _In_ USHORT SubSystemID
,
4786 typedef PCI_IS_DEVICE_PRESENT
*PPCI_IS_DEVICE_PRESENT
;
4788 _IRQL_requires_max_(PASSIVE_LEVEL
)
4789 _Must_inspect_result_
4791 (NTAPI PCI_IS_DEVICE_PRESENT_EX
)(
4793 _In_ PPCI_DEVICE_PRESENCE_PARAMETERS Parameters
);
4794 typedef PCI_IS_DEVICE_PRESENT_EX
*PPCI_IS_DEVICE_PRESENT_EX
;
4796 typedef struct _BUS_INTERFACE_STANDARD
{
4800 PINTERFACE_REFERENCE InterfaceReference
;
4801 PINTERFACE_DEREFERENCE InterfaceDereference
;
4802 PTRANSLATE_BUS_ADDRESS TranslateBusAddress
;
4803 PGET_DMA_ADAPTER GetDmaAdapter
;
4804 PGET_SET_DEVICE_DATA SetBusData
;
4805 PGET_SET_DEVICE_DATA GetBusData
;
4806 } BUS_INTERFACE_STANDARD
, *PBUS_INTERFACE_STANDARD
;
4808 typedef struct _PCI_DEVICE_PRESENT_INTERFACE
{
4812 PINTERFACE_REFERENCE InterfaceReference
;
4813 PINTERFACE_DEREFERENCE InterfaceDereference
;
4814 PPCI_IS_DEVICE_PRESENT IsDevicePresent
;
4815 PPCI_IS_DEVICE_PRESENT_EX IsDevicePresentEx
;
4816 } PCI_DEVICE_PRESENT_INTERFACE
, *PPCI_DEVICE_PRESENT_INTERFACE
;
4818 _Struct_size_bytes_(Size
)
4819 typedef struct _DEVICE_CAPABILITIES
{
4820 _Field_range_(==, sizeof(struct _DEVICE_CAPABILITIES
)) USHORT Size
;
4824 ULONG LockSupported
:1;
4825 ULONG EjectSupported
:1;
4829 ULONG SilentInstall
:1;
4830 ULONG RawDeviceOK
:1;
4831 ULONG SurpriseRemovalOK
:1;
4836 ULONG HardwareDisabled
:1;
4838 ULONG WarmEjectSupported
:1;
4839 ULONG NoDisplayInUI
:1;
4843 DEVICE_POWER_STATE DeviceState
[PowerSystemMaximum
];
4844 SYSTEM_POWER_STATE SystemWake
;
4845 DEVICE_POWER_STATE DeviceWake
;
4849 } DEVICE_CAPABILITIES
, *PDEVICE_CAPABILITIES
;
4851 typedef struct _DEVICE_INTERFACE_CHANGE_NOTIFICATION
{
4855 GUID InterfaceClassGuid
;
4856 PUNICODE_STRING SymbolicLinkName
;
4857 } DEVICE_INTERFACE_CHANGE_NOTIFICATION
, *PDEVICE_INTERFACE_CHANGE_NOTIFICATION
;
4859 typedef struct _HWPROFILE_CHANGE_NOTIFICATION
{
4863 } HWPROFILE_CHANGE_NOTIFICATION
, *PHWPROFILE_CHANGE_NOTIFICATION
;
4867 typedef struct _INTERFACE
{
4871 PINTERFACE_REFERENCE InterfaceReference
;
4872 PINTERFACE_DEREFERENCE InterfaceDereference
;
4873 } INTERFACE
, *PINTERFACE
;
4875 typedef struct _PLUGPLAY_NOTIFICATION_HEADER
{
4879 } PLUGPLAY_NOTIFICATION_HEADER
, *PPLUGPLAY_NOTIFICATION_HEADER
;
4881 typedef ULONG PNP_DEVICE_STATE
, *PPNP_DEVICE_STATE
;
4883 /* PNP_DEVICE_STATE */
4885 #define PNP_DEVICE_DISABLED 0x00000001
4886 #define PNP_DEVICE_DONT_DISPLAY_IN_UI 0x00000002
4887 #define PNP_DEVICE_FAILED 0x00000004
4888 #define PNP_DEVICE_REMOVED 0x00000008
4889 #define PNP_DEVICE_RESOURCE_REQUIREMENTS_CHANGED 0x00000010
4890 #define PNP_DEVICE_NOT_DISABLEABLE 0x00000020
4892 typedef struct _TARGET_DEVICE_CUSTOM_NOTIFICATION
{
4896 struct _FILE_OBJECT
*FileObject
;
4897 LONG NameBufferOffset
;
4898 UCHAR CustomDataBuffer
[1];
4899 } TARGET_DEVICE_CUSTOM_NOTIFICATION
, *PTARGET_DEVICE_CUSTOM_NOTIFICATION
;
4901 typedef struct _TARGET_DEVICE_REMOVAL_NOTIFICATION
{
4905 struct _FILE_OBJECT
*FileObject
;
4906 } TARGET_DEVICE_REMOVAL_NOTIFICATION
, *PTARGET_DEVICE_REMOVAL_NOTIFICATION
;
4908 #if (NTDDI_VERSION >= NTDDI_VISTA)
4909 #include <devpropdef.h>
4910 #define PLUGPLAY_PROPERTY_PERSISTENT 0x00000001
4913 #define PNP_REPLACE_NO_MAP MAXLONGLONG
4915 _Must_inspect_result_
4917 (NTAPI
*PREPLACE_MAP_MEMORY
)(
4918 _In_ PHYSICAL_ADDRESS TargetPhysicalAddress
,
4919 _In_ PHYSICAL_ADDRESS SparePhysicalAddress
,
4920 _Inout_ PLARGE_INTEGER NumberOfBytes
,
4921 _Outptr_ PVOID
*TargetAddress
,
4922 _Outptr_ PVOID
*SpareAddress
);
4924 typedef struct _PNP_REPLACE_MEMORY_LIST
{
4925 ULONG AllocatedCount
;
4927 ULONGLONG TotalLength
;
4929 PHYSICAL_ADDRESS Address
;
4931 } Ranges
[ANYSIZE_ARRAY
];
4932 } PNP_REPLACE_MEMORY_LIST
, *PPNP_REPLACE_MEMORY_LIST
;
4934 typedef struct _PNP_REPLACE_PROCESSOR_LIST
{
4935 PKAFFINITY Affinity
;
4936 _Field_range_(<=, MAXIMUM_GROUPS
) ULONG GroupCount
;
4937 ULONG AllocatedCount
;
4939 ULONG ApicIds
[ANYSIZE_ARRAY
];
4940 } PNP_REPLACE_PROCESSOR_LIST
, *PPNP_REPLACE_PROCESSOR_LIST
;
4942 typedef struct _PNP_REPLACE_PROCESSOR_LIST_V1
{
4943 KAFFINITY AffinityMask
;
4944 ULONG AllocatedCount
;
4946 ULONG ApicIds
[ANYSIZE_ARRAY
];
4947 } PNP_REPLACE_PROCESSOR_LIST_V1
, *PPNP_REPLACE_PROCESSOR_LIST_V1
;
4949 #define PNP_REPLACE_PARAMETERS_VERSION 2
4951 typedef struct _PNP_REPLACE_PARAMETERS
{
4956 PPNP_REPLACE_PROCESSOR_LIST TargetProcessors
;
4957 PPNP_REPLACE_PROCESSOR_LIST SpareProcessors
;
4958 PPNP_REPLACE_MEMORY_LIST TargetMemory
;
4959 PPNP_REPLACE_MEMORY_LIST SpareMemory
;
4960 PREPLACE_MAP_MEMORY MapMemory
;
4961 } PNP_REPLACE_PARAMETERS
, *PPNP_REPLACE_PARAMETERS
;
4964 (NTAPI
*PREPLACE_UNLOAD
)(
4967 _Must_inspect_result_
4969 (NTAPI
*PREPLACE_BEGIN
)(
4970 _In_ PPNP_REPLACE_PARAMETERS Parameters
,
4971 _Outptr_ PVOID
*Context
);
4973 _Must_inspect_result_
4975 (NTAPI
*PREPLACE_END
)(
4976 _In_ PVOID Context
);
4978 _Must_inspect_result_
4980 (NTAPI
*PREPLACE_MIRROR_PHYSICAL_MEMORY
)(
4982 _In_ PHYSICAL_ADDRESS PhysicalAddress
,
4983 _In_ LARGE_INTEGER ByteCount
);
4985 _Must_inspect_result_
4987 (NTAPI
*PREPLACE_SET_PROCESSOR_ID
)(
4990 _In_ BOOLEAN Target
);
4992 _Must_inspect_result_
4994 (NTAPI
*PREPLACE_SWAP
)(
4995 _In_ PVOID Context
);
4997 _Must_inspect_result_
4999 (NTAPI
*PREPLACE_INITIATE_HARDWARE_MIRROR
)(
5000 _In_ PVOID Context
);
5002 _Must_inspect_result_
5004 (NTAPI
*PREPLACE_MIRROR_PLATFORM_MEMORY
)(
5005 _In_ PVOID Context
);
5007 _Must_inspect_result_
5009 (NTAPI
*PREPLACE_GET_MEMORY_DESTINATION
)(
5011 _In_ PHYSICAL_ADDRESS SourceAddress
,
5012 _Out_ PPHYSICAL_ADDRESS DestinationAddress
);
5014 _Must_inspect_result_
5016 (NTAPI
*PREPLACE_ENABLE_DISABLE_HARDWARE_QUIESCE
)(
5018 _In_ BOOLEAN Enable
);
5020 #define PNP_REPLACE_DRIVER_INTERFACE_VERSION 1
5021 #define PNP_REPLACE_DRIVER_INTERFACE_MINIMUM_SIZE \
5022 FIELD_OFFSET(PNP_REPLACE_DRIVER_INTERFACE, InitiateHardwareMirror)
5024 #define PNP_REPLACE_MEMORY_SUPPORTED 0x0001
5025 #define PNP_REPLACE_PROCESSOR_SUPPORTED 0x0002
5026 #define PNP_REPLACE_HARDWARE_MEMORY_MIRRORING 0x0004
5027 #define PNP_REPLACE_HARDWARE_PAGE_COPY 0x0008
5028 #define PNP_REPLACE_HARDWARE_QUIESCE 0x0010
5030 typedef struct _PNP_REPLACE_DRIVER_INTERFACE
{
5034 PREPLACE_UNLOAD Unload
;
5035 PREPLACE_BEGIN BeginReplace
;
5036 PREPLACE_END EndReplace
;
5037 PREPLACE_MIRROR_PHYSICAL_MEMORY MirrorPhysicalMemory
;
5038 PREPLACE_SET_PROCESSOR_ID SetProcessorId
;
5040 PREPLACE_INITIATE_HARDWARE_MIRROR InitiateHardwareMirror
;
5041 PREPLACE_MIRROR_PLATFORM_MEMORY MirrorPlatformMemory
;
5042 PREPLACE_GET_MEMORY_DESTINATION GetMemoryDestination
;
5043 PREPLACE_ENABLE_DISABLE_HARDWARE_QUIESCE EnableDisableHardwareQuiesce
;
5044 } PNP_REPLACE_DRIVER_INTERFACE
, *PPNP_REPLACE_DRIVER_INTERFACE
;
5046 _Must_inspect_result_
5048 (NTAPI
*PREPLACE_DRIVER_INIT
)(
5049 _Inout_ PPNP_REPLACE_DRIVER_INTERFACE Interface
,
5052 typedef enum _DEVICE_USAGE_NOTIFICATION_TYPE
{
5053 DeviceUsageTypeUndefined
,
5054 DeviceUsageTypePaging
,
5055 DeviceUsageTypeHibernation
,
5056 DeviceUsageTypeDumpFile
5057 } DEVICE_USAGE_NOTIFICATION_TYPE
;
5059 typedef struct _POWER_SEQUENCE
{
5063 } POWER_SEQUENCE
, *PPOWER_SEQUENCE
;
5066 #define __string_type 0x1000
5067 #define __guid_type 0x2000
5068 #define __multiString_type 0x4000
5070 #define __string_type 0
5071 #define __guid_type 0
5072 #define __multiString_type 0
5076 DevicePropertyDeviceDescription
= 0x0 | __string_type
,
5077 DevicePropertyHardwareID
= 0x1 | __multiString_type
,
5078 DevicePropertyCompatibleIDs
= 0x2 | __multiString_type
,
5079 DevicePropertyBootConfiguration
= 0x3,
5080 DevicePropertyBootConfigurationTranslated
= 0x4,
5081 DevicePropertyClassName
= 0x5 | __string_type
,
5082 DevicePropertyClassGuid
= 0x6 | __string_type
,
5083 DevicePropertyDriverKeyName
= 0x7 | __string_type
,
5084 DevicePropertyManufacturer
= 0x8 | __string_type
,
5085 DevicePropertyFriendlyName
= 0x9 | __string_type
,
5086 DevicePropertyLocationInformation
= 0xa | __string_type
,
5087 DevicePropertyPhysicalDeviceObjectName
= 0xb | __string_type
,
5088 DevicePropertyBusTypeGuid
= 0xc | __guid_type
,
5089 DevicePropertyLegacyBusType
= 0xd,
5090 DevicePropertyBusNumber
= 0xe,
5091 DevicePropertyEnumeratorName
= 0xf | __string_type
,
5092 DevicePropertyAddress
= 0x10,
5093 DevicePropertyUINumber
= 0x11,
5094 DevicePropertyInstallState
= 0x12,
5095 DevicePropertyRemovalPolicy
= 0x13,
5096 DevicePropertyResourceRequirements
= 0x14,
5097 DevicePropertyAllocatedResources
= 0x15,
5098 DevicePropertyContainerID
= 0x16 | __string_type
5099 } DEVICE_REGISTRY_PROPERTY
;
5101 typedef enum _IO_NOTIFICATION_EVENT_CATEGORY
{
5102 EventCategoryReserved
,
5103 EventCategoryHardwareProfileChange
,
5104 EventCategoryDeviceInterfaceChange
,
5105 EventCategoryTargetDeviceChange
5106 } IO_NOTIFICATION_EVENT_CATEGORY
;
5108 typedef enum _IO_PRIORITY_HINT
{
5109 IoPriorityVeryLow
= 0,
5117 #define PNPNOTIFY_DEVICE_INTERFACE_INCLUDE_EXISTING_INTERFACES 0x00000001
5119 _Function_class_(DRIVER_NOTIFICATION_CALLBACK_ROUTINE
)
5120 _IRQL_requires_max_(PASSIVE_LEVEL
)
5122 (NTAPI DRIVER_NOTIFICATION_CALLBACK_ROUTINE
)(
5123 _In_ PVOID NotificationStructure
,
5124 _Inout_opt_ PVOID Context
);
5125 typedef DRIVER_NOTIFICATION_CALLBACK_ROUTINE
*PDRIVER_NOTIFICATION_CALLBACK_ROUTINE
;
5127 _Function_class_(DEVICE_CHANGE_COMPLETE_CALLBACK
)
5128 _IRQL_requires_same_
5130 (NTAPI DEVICE_CHANGE_COMPLETE_CALLBACK
)(
5131 _Inout_opt_ PVOID Context
);
5132 typedef DEVICE_CHANGE_COMPLETE_CALLBACK
*PDEVICE_CHANGE_COMPLETE_CALLBACK
;
5134 typedef enum _FILE_INFORMATION_CLASS
{
5135 FileDirectoryInformation
= 1,
5136 FileFullDirectoryInformation
,
5137 FileBothDirectoryInformation
,
5138 FileBasicInformation
,
5139 FileStandardInformation
,
5140 FileInternalInformation
,
5142 FileAccessInformation
,
5143 FileNameInformation
,
5144 FileRenameInformation
,
5145 FileLinkInformation
,
5146 FileNamesInformation
,
5147 FileDispositionInformation
,
5148 FilePositionInformation
,
5149 FileFullEaInformation
,
5150 FileModeInformation
,
5151 FileAlignmentInformation
,
5153 FileAllocationInformation
,
5154 FileEndOfFileInformation
,
5155 FileAlternateNameInformation
,
5156 FileStreamInformation
,
5157 FilePipeInformation
,
5158 FilePipeLocalInformation
,
5159 FilePipeRemoteInformation
,
5160 FileMailslotQueryInformation
,
5161 FileMailslotSetInformation
,
5162 FileCompressionInformation
,
5163 FileObjectIdInformation
,
5164 FileCompletionInformation
,
5165 FileMoveClusterInformation
,
5166 FileQuotaInformation
,
5167 FileReparsePointInformation
,
5168 FileNetworkOpenInformation
,
5169 FileAttributeTagInformation
,
5170 FileTrackingInformation
,
5171 FileIdBothDirectoryInformation
,
5172 FileIdFullDirectoryInformation
,
5173 FileValidDataLengthInformation
,
5174 FileShortNameInformation
,
5175 #if (NTDDI_VERSION >= NTDDI_VISTA)
5176 FileIoCompletionNotificationInformation
,
5177 FileIoStatusBlockRangeInformation
,
5178 FileIoPriorityHintInformation
,
5179 FileSfioReserveInformation
,
5180 FileSfioVolumeInformation
,
5181 FileHardLinkInformation
,
5182 FileProcessIdsUsingFileInformation
,
5183 FileNormalizedNameInformation
,
5184 FileNetworkPhysicalNameInformation
,
5186 #if (NTDDI_VERSION >= NTDDI_WIN7)
5187 FileIdGlobalTxDirectoryInformation
,
5188 FileIsRemoteDeviceInformation
,
5189 FileAttributeCacheInformation
,
5190 FileNumaNodeInformation
,
5191 FileStandardLinkInformation
,
5192 FileRemoteProtocolInformation
,
5194 FileMaximumInformation
5195 } FILE_INFORMATION_CLASS
, *PFILE_INFORMATION_CLASS
;
5197 typedef struct _FILE_POSITION_INFORMATION
{
5198 LARGE_INTEGER CurrentByteOffset
;
5199 } FILE_POSITION_INFORMATION
, *PFILE_POSITION_INFORMATION
;
5201 typedef struct _FILE_BASIC_INFORMATION
{
5202 LARGE_INTEGER CreationTime
;
5203 LARGE_INTEGER LastAccessTime
;
5204 LARGE_INTEGER LastWriteTime
;
5205 LARGE_INTEGER ChangeTime
;
5206 ULONG FileAttributes
;
5207 } FILE_BASIC_INFORMATION
, *PFILE_BASIC_INFORMATION
;
5209 typedef struct _FILE_IO_PRIORITY_HINT_INFORMATION
{
5210 IO_PRIORITY_HINT PriorityHint
;
5211 } FILE_IO_PRIORITY_HINT_INFORMATION
, *PFILE_IO_PRIORITY_HINT_INFORMATION
;
5213 typedef struct _FILE_IO_COMPLETION_NOTIFICATION_INFORMATION
{
5215 } FILE_IO_COMPLETION_NOTIFICATION_INFORMATION
, *PFILE_IO_COMPLETION_NOTIFICATION_INFORMATION
;
5217 typedef struct _FILE_IOSTATUSBLOCK_RANGE_INFORMATION
{
5218 PUCHAR IoStatusBlockRange
;
5220 } FILE_IOSTATUSBLOCK_RANGE_INFORMATION
, *PFILE_IOSTATUSBLOCK_RANGE_INFORMATION
;
5222 typedef struct _FILE_IS_REMOTE_DEVICE_INFORMATION
{
5224 } FILE_IS_REMOTE_DEVICE_INFORMATION
, *PFILE_IS_REMOTE_DEVICE_INFORMATION
;
5226 typedef struct _FILE_NUMA_NODE_INFORMATION
{
5228 } FILE_NUMA_NODE_INFORMATION
, *PFILE_NUMA_NODE_INFORMATION
;
5230 typedef struct _FILE_PROCESS_IDS_USING_FILE_INFORMATION
{
5231 ULONG NumberOfProcessIdsInList
;
5232 ULONG_PTR ProcessIdList
[1];
5233 } FILE_PROCESS_IDS_USING_FILE_INFORMATION
, *PFILE_PROCESS_IDS_USING_FILE_INFORMATION
;
5235 typedef struct _FILE_STANDARD_INFORMATION
{
5236 LARGE_INTEGER AllocationSize
;
5237 LARGE_INTEGER EndOfFile
;
5238 ULONG NumberOfLinks
;
5239 BOOLEAN DeletePending
;
5241 } FILE_STANDARD_INFORMATION
, *PFILE_STANDARD_INFORMATION
;
5243 typedef struct _FILE_NETWORK_OPEN_INFORMATION
{
5244 LARGE_INTEGER CreationTime
;
5245 LARGE_INTEGER LastAccessTime
;
5246 LARGE_INTEGER LastWriteTime
;
5247 LARGE_INTEGER ChangeTime
;
5248 LARGE_INTEGER AllocationSize
;
5249 LARGE_INTEGER EndOfFile
;
5250 ULONG FileAttributes
;
5251 } FILE_NETWORK_OPEN_INFORMATION
, *PFILE_NETWORK_OPEN_INFORMATION
;
5253 typedef enum _FSINFOCLASS
{
5254 FileFsVolumeInformation
= 1,
5255 FileFsLabelInformation
,
5256 FileFsSizeInformation
,
5257 FileFsDeviceInformation
,
5258 FileFsAttributeInformation
,
5259 FileFsControlInformation
,
5260 FileFsFullSizeInformation
,
5261 FileFsObjectIdInformation
,
5262 FileFsDriverPathInformation
,
5263 FileFsVolumeFlagsInformation
,
5264 FileFsMaximumInformation
5265 } FS_INFORMATION_CLASS
, *PFS_INFORMATION_CLASS
;
5267 typedef struct _FILE_FS_DEVICE_INFORMATION
{
5268 DEVICE_TYPE DeviceType
;
5269 ULONG Characteristics
;
5270 } FILE_FS_DEVICE_INFORMATION
, *PFILE_FS_DEVICE_INFORMATION
;
5272 typedef struct _FILE_FULL_EA_INFORMATION
{
5273 ULONG NextEntryOffset
;
5276 USHORT EaValueLength
;
5278 } FILE_FULL_EA_INFORMATION
, *PFILE_FULL_EA_INFORMATION
;
5280 typedef struct _FILE_SFIO_RESERVE_INFORMATION
{
5281 ULONG RequestsPerPeriod
;
5283 BOOLEAN RetryFailures
;
5284 BOOLEAN Discardable
;
5286 ULONG NumOutstandingRequests
;
5287 } FILE_SFIO_RESERVE_INFORMATION
, *PFILE_SFIO_RESERVE_INFORMATION
;
5289 typedef struct _FILE_SFIO_VOLUME_INFORMATION
{
5290 ULONG MaximumRequestsPerPeriod
;
5291 ULONG MinimumPeriod
;
5292 ULONG MinimumTransferSize
;
5293 } FILE_SFIO_VOLUME_INFORMATION
, *PFILE_SFIO_VOLUME_INFORMATION
;
5295 #define FILE_SKIP_COMPLETION_PORT_ON_SUCCESS 0x1
5296 #define FILE_SKIP_SET_EVENT_ON_HANDLE 0x2
5297 #define FILE_SKIP_SET_USER_EVENT_ON_FAST_IO 0x4
5299 #define FM_LOCK_BIT (0x1)
5300 #define FM_LOCK_BIT_V (0x0)
5301 #define FM_LOCK_WAITER_WOKEN (0x2)
5302 #define FM_LOCK_WAITER_INC (0x4)
5304 _Function_class_(FAST_IO_CHECK_IF_POSSIBLE
)
5305 _IRQL_requires_same_
5307 (NTAPI FAST_IO_CHECK_IF_POSSIBLE
)(
5308 _In_
struct _FILE_OBJECT
*FileObject
,
5309 _In_ PLARGE_INTEGER FileOffset
,
5313 _In_ BOOLEAN CheckForReadOperation
,
5314 _Out_ PIO_STATUS_BLOCK IoStatus
,
5315 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5316 typedef FAST_IO_CHECK_IF_POSSIBLE
*PFAST_IO_CHECK_IF_POSSIBLE
;
5318 _Function_class_(FAST_IO_READ
)
5319 _IRQL_requires_same_
5321 (NTAPI FAST_IO_READ
)(
5322 _In_
struct _FILE_OBJECT
*FileObject
,
5323 _In_ PLARGE_INTEGER FileOffset
,
5328 _Out_ PIO_STATUS_BLOCK IoStatus
,
5329 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5330 typedef FAST_IO_READ
*PFAST_IO_READ
;
5332 _Function_class_(FAST_IO_WRITE
)
5333 _IRQL_requires_same_
5335 (NTAPI FAST_IO_WRITE
)(
5336 _In_
struct _FILE_OBJECT
*FileObject
,
5337 _In_ PLARGE_INTEGER FileOffset
,
5342 _Out_ PIO_STATUS_BLOCK IoStatus
,
5343 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5344 typedef FAST_IO_WRITE
*PFAST_IO_WRITE
;
5346 _Function_class_(FAST_IO_QUERY_BASIC_INFO
)
5347 _IRQL_requires_same_
5349 (NTAPI FAST_IO_QUERY_BASIC_INFO
)(
5350 _In_
struct _FILE_OBJECT
*FileObject
,
5352 _Out_ PFILE_BASIC_INFORMATION Buffer
,
5353 _Out_ PIO_STATUS_BLOCK IoStatus
,
5354 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5355 typedef FAST_IO_QUERY_BASIC_INFO
*PFAST_IO_QUERY_BASIC_INFO
;
5357 _Function_class_(FAST_IO_QUERY_STANDARD_INFO
)
5358 _IRQL_requires_same_
5360 (NTAPI FAST_IO_QUERY_STANDARD_INFO
)(
5361 _In_
struct _FILE_OBJECT
*FileObject
,
5363 _Out_ PFILE_STANDARD_INFORMATION Buffer
,
5364 _Out_ PIO_STATUS_BLOCK IoStatus
,
5365 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5366 typedef FAST_IO_QUERY_STANDARD_INFO
*PFAST_IO_QUERY_STANDARD_INFO
;
5368 _Function_class_(FAST_IO_LOCK
)
5369 _IRQL_requires_same_
5371 (NTAPI FAST_IO_LOCK
)(
5372 _In_
struct _FILE_OBJECT
*FileObject
,
5373 _In_ PLARGE_INTEGER FileOffset
,
5374 _In_ PLARGE_INTEGER Length
,
5375 _In_ PEPROCESS ProcessId
,
5377 _In_ BOOLEAN FailImmediately
,
5378 _In_ BOOLEAN ExclusiveLock
,
5379 _Out_ PIO_STATUS_BLOCK IoStatus
,
5380 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5381 typedef FAST_IO_LOCK
*PFAST_IO_LOCK
;
5383 _Function_class_(FAST_IO_UNLOCK_SINGLE
)
5384 _IRQL_requires_same_
5386 (NTAPI FAST_IO_UNLOCK_SINGLE
)(
5387 _In_
struct _FILE_OBJECT
*FileObject
,
5388 _In_ PLARGE_INTEGER FileOffset
,
5389 _In_ PLARGE_INTEGER Length
,
5390 _In_ PEPROCESS ProcessId
,
5392 _Out_ PIO_STATUS_BLOCK IoStatus
,
5393 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5394 typedef FAST_IO_UNLOCK_SINGLE
*PFAST_IO_UNLOCK_SINGLE
;
5396 _Function_class_(FAST_IO_UNLOCK_ALL
)
5397 _IRQL_requires_same_
5399 (NTAPI FAST_IO_UNLOCK_ALL
)(
5400 _In_
struct _FILE_OBJECT
*FileObject
,
5401 _In_ PEPROCESS ProcessId
,
5402 _Out_ PIO_STATUS_BLOCK IoStatus
,
5403 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5404 typedef FAST_IO_UNLOCK_ALL
*PFAST_IO_UNLOCK_ALL
;
5406 _Function_class_(FAST_IO_UNLOCK_ALL_BY_KEY
)
5407 _IRQL_requires_same_
5409 (NTAPI FAST_IO_UNLOCK_ALL_BY_KEY
)(
5410 _In_
struct _FILE_OBJECT
*FileObject
,
5411 _In_ PVOID ProcessId
,
5413 _Out_ PIO_STATUS_BLOCK IoStatus
,
5414 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5415 typedef FAST_IO_UNLOCK_ALL_BY_KEY
*PFAST_IO_UNLOCK_ALL_BY_KEY
;
5417 _Function_class_(FAST_IO_DEVICE_CONTROL
)
5418 _IRQL_requires_same_
5420 (NTAPI FAST_IO_DEVICE_CONTROL
)(
5421 _In_
struct _FILE_OBJECT
*FileObject
,
5423 _In_opt_ PVOID InputBuffer
,
5424 _In_ ULONG InputBufferLength
,
5425 _Out_opt_ PVOID OutputBuffer
,
5426 _In_ ULONG OutputBufferLength
,
5427 _In_ ULONG IoControlCode
,
5428 _Out_ PIO_STATUS_BLOCK IoStatus
,
5429 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5430 typedef FAST_IO_DEVICE_CONTROL
*PFAST_IO_DEVICE_CONTROL
;
5432 _Function_class_(FAST_IO_ACQUIRE_FILE
)
5433 _IRQL_requires_same_
5435 (NTAPI FAST_IO_ACQUIRE_FILE
)(
5436 _In_
struct _FILE_OBJECT
*FileObject
);
5437 typedef FAST_IO_ACQUIRE_FILE
*PFAST_IO_ACQUIRE_FILE
;
5439 _Function_class_(FAST_IO_RELEASE_FILE
)
5440 _IRQL_requires_same_
5442 (NTAPI FAST_IO_RELEASE_FILE
)(
5443 _In_
struct _FILE_OBJECT
*FileObject
);
5444 typedef FAST_IO_RELEASE_FILE
*PFAST_IO_RELEASE_FILE
;
5446 _Function_class_(FAST_IO_DETACH_DEVICE
)
5447 _IRQL_requires_same_
5449 (NTAPI FAST_IO_DETACH_DEVICE
)(
5450 _In_
struct _DEVICE_OBJECT
*SourceDevice
,
5451 _In_
struct _DEVICE_OBJECT
*TargetDevice
);
5452 typedef FAST_IO_DETACH_DEVICE
*PFAST_IO_DETACH_DEVICE
;
5454 _Function_class_(FAST_IO_QUERY_NETWORK_OPEN_INFO
)
5455 _IRQL_requires_same_
5457 (NTAPI FAST_IO_QUERY_NETWORK_OPEN_INFO
)(
5458 _In_
struct _FILE_OBJECT
*FileObject
,
5460 _Out_
struct _FILE_NETWORK_OPEN_INFORMATION
*Buffer
,
5461 _Out_
struct _IO_STATUS_BLOCK
*IoStatus
,
5462 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5463 typedef FAST_IO_QUERY_NETWORK_OPEN_INFO
*PFAST_IO_QUERY_NETWORK_OPEN_INFO
;
5465 _Function_class_(FAST_IO_ACQUIRE_FOR_MOD_WRITE
)
5466 _IRQL_requires_same_
5468 (NTAPI FAST_IO_ACQUIRE_FOR_MOD_WRITE
)(
5469 _In_
struct _FILE_OBJECT
*FileObject
,
5470 _In_ PLARGE_INTEGER EndingOffset
,
5471 _Out_
struct _ERESOURCE
**ResourceToRelease
,
5472 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5473 typedef FAST_IO_ACQUIRE_FOR_MOD_WRITE
*PFAST_IO_ACQUIRE_FOR_MOD_WRITE
;
5475 _Function_class_(FAST_IO_MDL_READ
)
5476 _IRQL_requires_same_
5478 (NTAPI FAST_IO_MDL_READ
)(
5479 _In_
struct _FILE_OBJECT
*FileObject
,
5480 _In_ PLARGE_INTEGER FileOffset
,
5483 _Out_ PMDL
*MdlChain
,
5484 _Out_ PIO_STATUS_BLOCK IoStatus
,
5485 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5486 typedef FAST_IO_MDL_READ
*PFAST_IO_MDL_READ
;
5488 _Function_class_(FAST_IO_MDL_READ_COMPLETE
)
5489 _IRQL_requires_same_
5491 (NTAPI FAST_IO_MDL_READ_COMPLETE
)(
5492 _In_
struct _FILE_OBJECT
*FileObject
,
5494 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5495 typedef FAST_IO_MDL_READ_COMPLETE
*PFAST_IO_MDL_READ_COMPLETE
;
5497 _Function_class_(FAST_IO_PREPARE_MDL_WRITE
)
5498 _IRQL_requires_same_
5500 (NTAPI FAST_IO_PREPARE_MDL_WRITE
)(
5501 _In_
struct _FILE_OBJECT
*FileObject
,
5502 _In_ PLARGE_INTEGER FileOffset
,
5505 _Out_ PMDL
*MdlChain
,
5506 _Out_ PIO_STATUS_BLOCK IoStatus
,
5507 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5508 typedef FAST_IO_PREPARE_MDL_WRITE
*PFAST_IO_PREPARE_MDL_WRITE
;
5510 _Function_class_(FAST_IO_MDL_WRITE_COMPLETE
)
5511 _IRQL_requires_same_
5513 (NTAPI FAST_IO_MDL_WRITE_COMPLETE
)(
5514 _In_
struct _FILE_OBJECT
*FileObject
,
5515 _In_ PLARGE_INTEGER FileOffset
,
5517 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5518 typedef FAST_IO_MDL_WRITE_COMPLETE
*PFAST_IO_MDL_WRITE_COMPLETE
;
5520 _Function_class_(FAST_IO_READ_COMPRESSED
)
5521 _IRQL_requires_same_
5523 (NTAPI FAST_IO_READ_COMPRESSED
)(
5524 _In_
struct _FILE_OBJECT
*FileObject
,
5525 _In_ PLARGE_INTEGER FileOffset
,
5529 _Out_ PMDL
*MdlChain
,
5530 _Out_ PIO_STATUS_BLOCK IoStatus
,
5531 _Out_
struct _COMPRESSED_DATA_INFO
*CompressedDataInfo
,
5532 _In_ ULONG CompressedDataInfoLength
,
5533 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5534 typedef FAST_IO_READ_COMPRESSED
*PFAST_IO_READ_COMPRESSED
;
5536 _Function_class_(FAST_IO_WRITE_COMPRESSED
)
5537 _IRQL_requires_same_
5539 (NTAPI FAST_IO_WRITE_COMPRESSED
)(
5540 _In_
struct _FILE_OBJECT
*FileObject
,
5541 _In_ PLARGE_INTEGER FileOffset
,
5545 _Out_ PMDL
*MdlChain
,
5546 _Out_ PIO_STATUS_BLOCK IoStatus
,
5547 _In_
struct _COMPRESSED_DATA_INFO
*CompressedDataInfo
,
5548 _In_ ULONG CompressedDataInfoLength
,
5549 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5550 typedef FAST_IO_WRITE_COMPRESSED
*PFAST_IO_WRITE_COMPRESSED
;
5552 _Function_class_(FAST_IO_MDL_READ_COMPLETE_COMPRESSED
)
5553 _IRQL_requires_same_
5555 (NTAPI FAST_IO_MDL_READ_COMPLETE_COMPRESSED
)(
5556 _In_
struct _FILE_OBJECT
*FileObject
,
5558 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5559 typedef FAST_IO_MDL_READ_COMPLETE_COMPRESSED
*PFAST_IO_MDL_READ_COMPLETE_COMPRESSED
;
5561 _Function_class_(FAST_IO_MDL_WRITE_COMPLETE_COMPRESSED
)
5562 _IRQL_requires_same_
5564 (NTAPI FAST_IO_MDL_WRITE_COMPLETE_COMPRESSED
)(
5565 _In_
struct _FILE_OBJECT
*FileObject
,
5566 _In_ PLARGE_INTEGER FileOffset
,
5568 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5569 typedef FAST_IO_MDL_WRITE_COMPLETE_COMPRESSED
*PFAST_IO_MDL_WRITE_COMPLETE_COMPRESSED
;
5571 _Function_class_(FAST_IO_QUERY_OPEN
)
5572 _IRQL_requires_same_
5574 (NTAPI FAST_IO_QUERY_OPEN
)(
5575 _Inout_
struct _IRP
*Irp
,
5576 _Out_ PFILE_NETWORK_OPEN_INFORMATION NetworkInformation
,
5577 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5578 typedef FAST_IO_QUERY_OPEN
*PFAST_IO_QUERY_OPEN
;
5580 _Function_class_(FAST_IO_RELEASE_FOR_MOD_WRITE
)
5581 _IRQL_requires_same_
5583 (NTAPI FAST_IO_RELEASE_FOR_MOD_WRITE
)(
5584 _In_
struct _FILE_OBJECT
*FileObject
,
5585 _In_
struct _ERESOURCE
*ResourceToRelease
,
5586 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5587 typedef FAST_IO_RELEASE_FOR_MOD_WRITE
*PFAST_IO_RELEASE_FOR_MOD_WRITE
;
5589 _Function_class_(FAST_IO_ACQUIRE_FOR_CCFLUSH
)
5590 _IRQL_requires_same_
5592 (NTAPI FAST_IO_ACQUIRE_FOR_CCFLUSH
)(
5593 _In_
struct _FILE_OBJECT
*FileObject
,
5594 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5595 typedef FAST_IO_ACQUIRE_FOR_CCFLUSH
*PFAST_IO_ACQUIRE_FOR_CCFLUSH
;
5597 _Function_class_(FAST_IO_RELEASE_FOR_CCFLUSH
)
5598 _IRQL_requires_same_
5600 (NTAPI FAST_IO_RELEASE_FOR_CCFLUSH
)(
5601 _In_
struct _FILE_OBJECT
*FileObject
,
5602 _In_
struct _DEVICE_OBJECT
*DeviceObject
);
5603 typedef FAST_IO_RELEASE_FOR_CCFLUSH
*PFAST_IO_RELEASE_FOR_CCFLUSH
;
5605 typedef struct _FAST_IO_DISPATCH
{
5606 ULONG SizeOfFastIoDispatch
;
5607 PFAST_IO_CHECK_IF_POSSIBLE FastIoCheckIfPossible
;
5608 PFAST_IO_READ FastIoRead
;
5609 PFAST_IO_WRITE FastIoWrite
;
5610 PFAST_IO_QUERY_BASIC_INFO FastIoQueryBasicInfo
;
5611 PFAST_IO_QUERY_STANDARD_INFO FastIoQueryStandardInfo
;
5612 PFAST_IO_LOCK FastIoLock
;
5613 PFAST_IO_UNLOCK_SINGLE FastIoUnlockSingle
;
5614 PFAST_IO_UNLOCK_ALL FastIoUnlockAll
;
5615 PFAST_IO_UNLOCK_ALL_BY_KEY FastIoUnlockAllByKey
;
5616 PFAST_IO_DEVICE_CONTROL FastIoDeviceControl
;
5617 PFAST_IO_ACQUIRE_FILE AcquireFileForNtCreateSection
;
5618 PFAST_IO_RELEASE_FILE ReleaseFileForNtCreateSection
;
5619 PFAST_IO_DETACH_DEVICE FastIoDetachDevice
;
5620 PFAST_IO_QUERY_NETWORK_OPEN_INFO FastIoQueryNetworkOpenInfo
;
5621 PFAST_IO_ACQUIRE_FOR_MOD_WRITE AcquireForModWrite
;
5622 PFAST_IO_MDL_READ MdlRead
;
5623 PFAST_IO_MDL_READ_COMPLETE MdlReadComplete
;
5624 PFAST_IO_PREPARE_MDL_WRITE PrepareMdlWrite
;
5625 PFAST_IO_MDL_WRITE_COMPLETE MdlWriteComplete
;
5626 PFAST_IO_READ_COMPRESSED FastIoReadCompressed
;
5627 PFAST_IO_WRITE_COMPRESSED FastIoWriteCompressed
;
5628 PFAST_IO_MDL_READ_COMPLETE_COMPRESSED MdlReadCompleteCompressed
;
5629 PFAST_IO_MDL_WRITE_COMPLETE_COMPRESSED MdlWriteCompleteCompressed
;
5630 PFAST_IO_QUERY_OPEN FastIoQueryOpen
;
5631 PFAST_IO_RELEASE_FOR_MOD_WRITE ReleaseForModWrite
;
5632 PFAST_IO_ACQUIRE_FOR_CCFLUSH AcquireForCcFlush
;
5633 PFAST_IO_RELEASE_FOR_CCFLUSH ReleaseForCcFlush
;
5634 } FAST_IO_DISPATCH
, *PFAST_IO_DISPATCH
;
5636 typedef struct _SECTION_OBJECT_POINTERS
{
5637 PVOID DataSectionObject
;
5638 PVOID SharedCacheMap
;
5639 PVOID ImageSectionObject
;
5640 } SECTION_OBJECT_POINTERS
, *PSECTION_OBJECT_POINTERS
;
5642 typedef struct _IO_COMPLETION_CONTEXT
{
5645 } IO_COMPLETION_CONTEXT
, *PIO_COMPLETION_CONTEXT
;
5647 /* FILE_OBJECT.Flags */
5648 #define FO_FILE_OPEN 0x00000001
5649 #define FO_SYNCHRONOUS_IO 0x00000002
5650 #define FO_ALERTABLE_IO 0x00000004
5651 #define FO_NO_INTERMEDIATE_BUFFERING 0x00000008
5652 #define FO_WRITE_THROUGH 0x00000010
5653 #define FO_SEQUENTIAL_ONLY 0x00000020
5654 #define FO_CACHE_SUPPORTED 0x00000040
5655 #define FO_NAMED_PIPE 0x00000080
5656 #define FO_STREAM_FILE 0x00000100
5657 #define FO_MAILSLOT 0x00000200
5658 #define FO_GENERATE_AUDIT_ON_CLOSE 0x00000400
5659 #define FO_QUEUE_IRP_TO_THREAD 0x00000400
5660 #define FO_DIRECT_DEVICE_OPEN 0x00000800
5661 #define FO_FILE_MODIFIED 0x00001000
5662 #define FO_FILE_SIZE_CHANGED 0x00002000
5663 #define FO_CLEANUP_COMPLETE 0x00004000
5664 #define FO_TEMPORARY_FILE 0x00008000
5665 #define FO_DELETE_ON_CLOSE 0x00010000
5666 #define FO_OPENED_CASE_SENSITIVE 0x00020000
5667 #define FO_HANDLE_CREATED 0x00040000
5668 #define FO_FILE_FAST_IO_READ 0x00080000
5669 #define FO_RANDOM_ACCESS 0x00100000
5670 #define FO_FILE_OPEN_CANCELLED 0x00200000
5671 #define FO_VOLUME_OPEN 0x00400000
5672 #define FO_REMOTE_ORIGIN 0x01000000
5673 #define FO_DISALLOW_EXCLUSIVE 0x02000000
5674 #define FO_SKIP_COMPLETION_PORT 0x02000000
5675 #define FO_SKIP_SET_EVENT 0x04000000
5676 #define FO_SKIP_SET_FAST_IO 0x08000000
5677 #define FO_FLAGS_VALID_ONLY_DURING_CREATE FO_DISALLOW_EXCLUSIVE
5680 #define VPB_MOUNTED 0x0001
5681 #define VPB_LOCKED 0x0002
5682 #define VPB_PERSISTENT 0x0004
5683 #define VPB_REMOVE_PENDING 0x0008
5684 #define VPB_RAW_MOUNT 0x0010
5685 #define VPB_DIRECT_WRITES_ALLOWED 0x0020
5689 #define SL_FORCE_ACCESS_CHECK 0x01
5690 #define SL_OPEN_PAGING_FILE 0x02
5691 #define SL_OPEN_TARGET_DIRECTORY 0x04
5692 #define SL_STOP_ON_SYMLINK 0x08
5693 #define SL_CASE_SENSITIVE 0x80
5695 #define SL_KEY_SPECIFIED 0x01
5696 #define SL_OVERRIDE_VERIFY_VOLUME 0x02
5697 #define SL_WRITE_THROUGH 0x04
5698 #define SL_FT_SEQUENTIAL_WRITE 0x08
5699 #define SL_FORCE_DIRECT_WRITE 0x10
5700 #define SL_REALTIME_STREAM 0x20
5702 #define SL_READ_ACCESS_GRANTED 0x01
5703 #define SL_WRITE_ACCESS_GRANTED 0x04
5705 #define SL_FAIL_IMMEDIATELY 0x01
5706 #define SL_EXCLUSIVE_LOCK 0x02
5708 #define SL_RESTART_SCAN 0x01
5709 #define SL_RETURN_SINGLE_ENTRY 0x02
5710 #define SL_INDEX_SPECIFIED 0x04
5712 #define SL_WATCH_TREE 0x01
5714 #define SL_ALLOW_RAW_MOUNT 0x01
5716 #define CTL_CODE(DeviceType, Function, Method, Access) \
5717 (((DeviceType) << 16) | ((Access) << 14) | ((Function) << 2) | (Method))
5719 #define DEVICE_TYPE_FROM_CTL_CODE(ctl) (((ULONG) (ctl & 0xffff0000)) >> 16)
5721 #define METHOD_FROM_CTL_CODE(ctrlCode) ((ULONG)(ctrlCode & 3))
5723 #define IRP_NOCACHE 0x00000001
5724 #define IRP_PAGING_IO 0x00000002
5725 #define IRP_MOUNT_COMPLETION 0x00000002
5726 #define IRP_SYNCHRONOUS_API 0x00000004
5727 #define IRP_ASSOCIATED_IRP 0x00000008
5728 #define IRP_BUFFERED_IO 0x00000010
5729 #define IRP_DEALLOCATE_BUFFER 0x00000020
5730 #define IRP_INPUT_OPERATION 0x00000040
5731 #define IRP_SYNCHRONOUS_PAGING_IO 0x00000040
5732 #define IRP_CREATE_OPERATION 0x00000080
5733 #define IRP_READ_OPERATION 0x00000100
5734 #define IRP_WRITE_OPERATION 0x00000200
5735 #define IRP_CLOSE_OPERATION 0x00000400
5736 #define IRP_DEFER_IO_COMPLETION 0x00000800
5737 #define IRP_OB_QUERY_NAME 0x00001000
5738 #define IRP_HOLD_DEVICE_QUEUE 0x00002000
5739 /* The following 2 are missing in latest WDK */
5740 #define IRP_RETRY_IO_COMPLETION 0x00004000
5741 #define IRP_CLASS_CACHE_OPERATION 0x00008000
5743 #define IRP_QUOTA_CHARGED 0x01
5744 #define IRP_ALLOCATED_MUST_SUCCEED 0x02
5745 #define IRP_ALLOCATED_FIXED_SIZE 0x04
5746 #define IRP_LOOKASIDE_ALLOCATION 0x08
5749 ** IRP function codes
5752 #define IRP_MJ_CREATE 0x00
5753 #define IRP_MJ_CREATE_NAMED_PIPE 0x01
5754 #define IRP_MJ_CLOSE 0x02
5755 #define IRP_MJ_READ 0x03
5756 #define IRP_MJ_WRITE 0x04
5757 #define IRP_MJ_QUERY_INFORMATION 0x05
5758 #define IRP_MJ_SET_INFORMATION 0x06
5759 #define IRP_MJ_QUERY_EA 0x07
5760 #define IRP_MJ_SET_EA 0x08
5761 #define IRP_MJ_FLUSH_BUFFERS 0x09
5762 #define IRP_MJ_QUERY_VOLUME_INFORMATION 0x0a
5763 #define IRP_MJ_SET_VOLUME_INFORMATION 0x0b
5764 #define IRP_MJ_DIRECTORY_CONTROL 0x0c
5765 #define IRP_MJ_FILE_SYSTEM_CONTROL 0x0d
5766 #define IRP_MJ_DEVICE_CONTROL 0x0e
5767 #define IRP_MJ_INTERNAL_DEVICE_CONTROL 0x0f
5768 #define IRP_MJ_SCSI 0x0f
5769 #define IRP_MJ_SHUTDOWN 0x10
5770 #define IRP_MJ_LOCK_CONTROL 0x11
5771 #define IRP_MJ_CLEANUP 0x12
5772 #define IRP_MJ_CREATE_MAILSLOT 0x13
5773 #define IRP_MJ_QUERY_SECURITY 0x14
5774 #define IRP_MJ_SET_SECURITY 0x15
5775 #define IRP_MJ_POWER 0x16
5776 #define IRP_MJ_SYSTEM_CONTROL 0x17
5777 #define IRP_MJ_DEVICE_CHANGE 0x18
5778 #define IRP_MJ_QUERY_QUOTA 0x19
5779 #define IRP_MJ_SET_QUOTA 0x1a
5780 #define IRP_MJ_PNP 0x1b
5781 #define IRP_MJ_PNP_POWER 0x1b
5782 #define IRP_MJ_MAXIMUM_FUNCTION 0x1b
5784 #define IRP_MN_SCSI_CLASS 0x01
5786 #define IRP_MN_START_DEVICE 0x00
5787 #define IRP_MN_QUERY_REMOVE_DEVICE 0x01
5788 #define IRP_MN_REMOVE_DEVICE 0x02
5789 #define IRP_MN_CANCEL_REMOVE_DEVICE 0x03
5790 #define IRP_MN_STOP_DEVICE 0x04
5791 #define IRP_MN_QUERY_STOP_DEVICE 0x05
5792 #define IRP_MN_CANCEL_STOP_DEVICE 0x06
5794 #define IRP_MN_QUERY_DEVICE_RELATIONS 0x07
5795 #define IRP_MN_QUERY_INTERFACE 0x08
5796 #define IRP_MN_QUERY_CAPABILITIES 0x09
5797 #define IRP_MN_QUERY_RESOURCES 0x0A
5798 #define IRP_MN_QUERY_RESOURCE_REQUIREMENTS 0x0B
5799 #define IRP_MN_QUERY_DEVICE_TEXT 0x0C
5800 #define IRP_MN_FILTER_RESOURCE_REQUIREMENTS 0x0D
5802 #define IRP_MN_READ_CONFIG 0x0F
5803 #define IRP_MN_WRITE_CONFIG 0x10
5804 #define IRP_MN_EJECT 0x11
5805 #define IRP_MN_SET_LOCK 0x12
5806 #define IRP_MN_QUERY_ID 0x13
5807 #define IRP_MN_QUERY_PNP_DEVICE_STATE 0x14
5808 #define IRP_MN_QUERY_BUS_INFORMATION 0x15
5809 #define IRP_MN_DEVICE_USAGE_NOTIFICATION 0x16
5810 #define IRP_MN_SURPRISE_REMOVAL 0x17
5811 #if (NTDDI_VERSION >= NTDDI_WIN7)
5812 #define IRP_MN_DEVICE_ENUMERATED 0x19
5815 #define IRP_MN_WAIT_WAKE 0x00
5816 #define IRP_MN_POWER_SEQUENCE 0x01
5817 #define IRP_MN_SET_POWER 0x02
5818 #define IRP_MN_QUERY_POWER 0x03
5820 #define IRP_MN_QUERY_ALL_DATA 0x00
5821 #define IRP_MN_QUERY_SINGLE_INSTANCE 0x01
5822 #define IRP_MN_CHANGE_SINGLE_INSTANCE 0x02
5823 #define IRP_MN_CHANGE_SINGLE_ITEM 0x03
5824 #define IRP_MN_ENABLE_EVENTS 0x04
5825 #define IRP_MN_DISABLE_EVENTS 0x05
5826 #define IRP_MN_ENABLE_COLLECTION 0x06
5827 #define IRP_MN_DISABLE_COLLECTION 0x07
5828 #define IRP_MN_REGINFO 0x08
5829 #define IRP_MN_EXECUTE_METHOD 0x09
5831 #define IRP_MN_REGINFO_EX 0x0b
5833 typedef struct _FILE_OBJECT
{
5836 PDEVICE_OBJECT DeviceObject
;
5840 PSECTION_OBJECT_POINTERS SectionObjectPointer
;
5841 PVOID PrivateCacheMap
;
5842 NTSTATUS FinalStatus
;
5843 struct _FILE_OBJECT
*RelatedFileObject
;
5844 BOOLEAN LockOperation
;
5845 BOOLEAN DeletePending
;
5847 BOOLEAN WriteAccess
;
5848 BOOLEAN DeleteAccess
;
5850 BOOLEAN SharedWrite
;
5851 BOOLEAN SharedDelete
;
5853 UNICODE_STRING FileName
;
5854 LARGE_INTEGER CurrentByteOffset
;
5855 volatile ULONG Waiters
;
5856 volatile ULONG Busy
;
5860 volatile PIO_COMPLETION_CONTEXT CompletionContext
;
5861 KSPIN_LOCK IrpListLock
;
5863 volatile PVOID FileObjectExtension
;
5864 } FILE_OBJECT
, *PFILE_OBJECT
;
5866 typedef struct _IO_ERROR_LOG_PACKET
{
5867 UCHAR MajorFunctionCode
;
5869 USHORT DumpDataSize
;
5870 USHORT NumberOfStrings
;
5871 USHORT StringOffset
;
5872 USHORT EventCategory
;
5874 ULONG UniqueErrorValue
;
5875 NTSTATUS FinalStatus
;
5876 ULONG SequenceNumber
;
5877 ULONG IoControlCode
;
5878 LARGE_INTEGER DeviceOffset
;
5880 } IO_ERROR_LOG_PACKET
, *PIO_ERROR_LOG_PACKET
;
5882 typedef struct _IO_ERROR_LOG_MESSAGE
{
5885 USHORT DriverNameLength
;
5886 LARGE_INTEGER TimeStamp
;
5887 ULONG DriverNameOffset
;
5888 IO_ERROR_LOG_PACKET EntryData
;
5889 } IO_ERROR_LOG_MESSAGE
, *PIO_ERROR_LOG_MESSAGE
;
5891 #define ERROR_LOG_LIMIT_SIZE 240
5892 #define IO_ERROR_LOG_MESSAGE_HEADER_LENGTH (sizeof(IO_ERROR_LOG_MESSAGE) - \
5893 sizeof(IO_ERROR_LOG_PACKET) + \
5894 (sizeof(WCHAR) * 40))
5895 #define ERROR_LOG_MESSAGE_LIMIT_SIZE \
5896 (ERROR_LOG_LIMIT_SIZE + IO_ERROR_LOG_MESSAGE_HEADER_LENGTH)
5897 #define IO_ERROR_LOG_MESSAGE_LENGTH \
5898 ((PORT_MAXIMUM_MESSAGE_LENGTH > ERROR_LOG_MESSAGE_LIMIT_SIZE) ? \
5899 ERROR_LOG_MESSAGE_LIMIT_SIZE : \
5900 PORT_MAXIMUM_MESSAGE_LENGTH)
5901 #define ERROR_LOG_MAXIMUM_SIZE (IO_ERROR_LOG_MESSAGE_LENGTH - \
5902 IO_ERROR_LOG_MESSAGE_HEADER_LENGTH)
5905 #define PORT_MAXIMUM_MESSAGE_LENGTH 512
5907 #define PORT_MAXIMUM_MESSAGE_LENGTH 256
5910 typedef enum _DMA_WIDTH
{
5915 } DMA_WIDTH
, *PDMA_WIDTH
;
5917 typedef enum _DMA_SPEED
{
5924 } DMA_SPEED
, *PDMA_SPEED
;
5926 /* DEVICE_DESCRIPTION.Version */
5928 #define DEVICE_DESCRIPTION_VERSION 0x0000
5929 #define DEVICE_DESCRIPTION_VERSION1 0x0001
5930 #define DEVICE_DESCRIPTION_VERSION2 0x0002
5932 typedef struct _DEVICE_DESCRIPTION
{
5935 BOOLEAN ScatterGather
;
5937 BOOLEAN AutoInitialize
;
5938 BOOLEAN Dma32BitAddresses
;
5939 BOOLEAN IgnoreCount
;
5941 BOOLEAN Dma64BitAddresses
;
5944 INTERFACE_TYPE InterfaceType
;
5947 ULONG MaximumLength
;
5949 } DEVICE_DESCRIPTION
, *PDEVICE_DESCRIPTION
;
5951 typedef enum _DEVICE_RELATION_TYPE
{
5956 TargetDeviceRelation
,
5959 } DEVICE_RELATION_TYPE
, *PDEVICE_RELATION_TYPE
;
5961 typedef struct _DEVICE_RELATIONS
{
5963 PDEVICE_OBJECT Objects
[1];
5964 } DEVICE_RELATIONS
, *PDEVICE_RELATIONS
;
5966 typedef struct _DEVOBJ_EXTENSION
{
5969 PDEVICE_OBJECT DeviceObject
;
5970 } DEVOBJ_EXTENSION
, *PDEVOBJ_EXTENSION
;
5972 typedef struct _SCATTER_GATHER_ELEMENT
{
5973 PHYSICAL_ADDRESS Address
;
5976 } SCATTER_GATHER_ELEMENT
, *PSCATTER_GATHER_ELEMENT
;
5978 #if defined(_MSC_EXTENSIONS) || defined(__GNUC__)
5980 #if defined(_MSC_VER)
5981 #if _MSC_VER >= 1200
5982 #pragma warning(push)
5984 #pragma warning(disable:4200)
5985 #endif /* _MSC_VER */
5987 typedef struct _SCATTER_GATHER_LIST
{
5988 ULONG NumberOfElements
;
5990 SCATTER_GATHER_ELEMENT Elements
[1];
5991 } SCATTER_GATHER_LIST
, *PSCATTER_GATHER_LIST
;
5993 #if defined(_MSC_VER)
5994 #if _MSC_VER >= 1200
5995 #pragma warning(pop)
5997 #pragma warning(default:4200)
5999 #endif /* _MSC_VER */
6001 #else /* defined(_MSC_EXTENSIONS) || defined(__GNUC__) */
6003 struct _SCATTER_GATHER_LIST
;
6004 typedef struct _SCATTER_GATHER_LIST SCATTER_GATHER_LIST
, *PSCATTER_GATHER_LIST
;
6006 #endif /* defined(_MSC_EXTENSIONS) || defined(__GNUC__) */
6008 _Function_class_(DRIVER_ADD_DEVICE
)
6009 _IRQL_requires_(PASSIVE_LEVEL
)
6010 _IRQL_requires_same_
6011 _When_(return>=0, _Kernel_clear_do_init_(__yes
))
6013 (NTAPI DRIVER_ADD_DEVICE
)(
6014 _In_
struct _DRIVER_OBJECT
*DriverObject
,
6015 _In_
struct _DEVICE_OBJECT
*PhysicalDeviceObject
);
6016 typedef DRIVER_ADD_DEVICE
*PDRIVER_ADD_DEVICE
;
6018 typedef struct _DRIVER_EXTENSION
{
6019 struct _DRIVER_OBJECT
*DriverObject
;
6020 PDRIVER_ADD_DEVICE AddDevice
;
6022 UNICODE_STRING ServiceKeyName
;
6023 } DRIVER_EXTENSION
, *PDRIVER_EXTENSION
;
6025 #define DRVO_UNLOAD_INVOKED 0x00000001
6026 #define DRVO_LEGACY_DRIVER 0x00000002
6027 #define DRVO_BUILTIN_DRIVER 0x00000004
6029 _Function_class_(DRIVER_INITIALIZE
)
6030 _IRQL_requires_same_
6032 (NTAPI DRIVER_INITIALIZE
)(
6033 _In_
struct _DRIVER_OBJECT
*DriverObject
,
6034 _In_ PUNICODE_STRING RegistryPath
);
6035 typedef DRIVER_INITIALIZE
*PDRIVER_INITIALIZE
;
6037 _Function_class_(DRIVER_STARTIO
)
6038 _IRQL_always_function_min_(DISPATCH_LEVEL
)
6039 _IRQL_requires_(DISPATCH_LEVEL
)
6040 _IRQL_requires_same_
6042 (NTAPI DRIVER_STARTIO
)(
6043 _Inout_
struct _DEVICE_OBJECT
*DeviceObject
,
6044 _Inout_
struct _IRP
*Irp
);
6045 typedef DRIVER_STARTIO
*PDRIVER_STARTIO
;
6047 _Function_class_(DRIVER_UNLOAD
)
6048 _IRQL_requires_(PASSIVE_LEVEL
)
6049 _IRQL_requires_same_
6051 (NTAPI DRIVER_UNLOAD
)(
6052 _In_
struct _DRIVER_OBJECT
*DriverObject
);
6053 typedef DRIVER_UNLOAD
*PDRIVER_UNLOAD
;
6055 _Function_class_(DRIVER_DISPATCH
)
6056 _IRQL_requires_(PASSIVE_LEVEL
)
6057 _IRQL_requires_same_
6059 (NTAPI DRIVER_DISPATCH
)(
6060 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
6061 _Inout_
struct _IRP
*Irp
);
6062 typedef DRIVER_DISPATCH
*PDRIVER_DISPATCH
;
6064 typedef struct _DRIVER_OBJECT
{
6067 PDEVICE_OBJECT DeviceObject
;
6071 PVOID DriverSection
;
6072 PDRIVER_EXTENSION DriverExtension
;
6073 UNICODE_STRING DriverName
;
6074 PUNICODE_STRING HardwareDatabase
;
6075 struct _FAST_IO_DISPATCH
*FastIoDispatch
;
6076 PDRIVER_INITIALIZE DriverInit
;
6077 PDRIVER_STARTIO DriverStartIo
;
6078 PDRIVER_UNLOAD DriverUnload
;
6079 PDRIVER_DISPATCH MajorFunction
[IRP_MJ_MAXIMUM_FUNCTION
+ 1];
6080 } DRIVER_OBJECT
, *PDRIVER_OBJECT
;
6082 typedef struct _DMA_ADAPTER
{
6085 struct _DMA_OPERATIONS
* DmaOperations
;
6086 } DMA_ADAPTER
, *PDMA_ADAPTER
;
6089 (NTAPI
*PPUT_DMA_ADAPTER
)(
6090 PDMA_ADAPTER DmaAdapter
);
6093 (NTAPI
*PALLOCATE_COMMON_BUFFER
)(
6094 _In_ PDMA_ADAPTER DmaAdapter
,
6096 _Out_ PPHYSICAL_ADDRESS LogicalAddress
,
6097 _In_ BOOLEAN CacheEnabled
);
6100 (NTAPI
*PFREE_COMMON_BUFFER
)(
6101 _In_ PDMA_ADAPTER DmaAdapter
,
6103 _In_ PHYSICAL_ADDRESS LogicalAddress
,
6104 _In_ PVOID VirtualAddress
,
6105 _In_ BOOLEAN CacheEnabled
);
6108 (NTAPI
*PALLOCATE_ADAPTER_CHANNEL
)(
6109 _In_ PDMA_ADAPTER DmaAdapter
,
6110 _In_ PDEVICE_OBJECT DeviceObject
,
6111 _In_ ULONG NumberOfMapRegisters
,
6112 _In_ PDRIVER_CONTROL ExecutionRoutine
,
6113 _In_ PVOID Context
);
6116 (NTAPI
*PFLUSH_ADAPTER_BUFFERS
)(
6117 _In_ PDMA_ADAPTER DmaAdapter
,
6119 _In_ PVOID MapRegisterBase
,
6120 _In_ PVOID CurrentVa
,
6122 _In_ BOOLEAN WriteToDevice
);
6125 (NTAPI
*PFREE_ADAPTER_CHANNEL
)(
6126 _In_ PDMA_ADAPTER DmaAdapter
);
6129 (NTAPI
*PFREE_MAP_REGISTERS
)(
6130 _In_ PDMA_ADAPTER DmaAdapter
,
6131 PVOID MapRegisterBase
,
6132 ULONG NumberOfMapRegisters
);
6134 typedef PHYSICAL_ADDRESS
6135 (NTAPI
*PMAP_TRANSFER
)(
6136 _In_ PDMA_ADAPTER DmaAdapter
,
6138 _In_ PVOID MapRegisterBase
,
6139 _In_ PVOID CurrentVa
,
6140 _Inout_ PULONG Length
,
6141 _In_ BOOLEAN WriteToDevice
);
6144 (NTAPI
*PGET_DMA_ALIGNMENT
)(
6145 _In_ PDMA_ADAPTER DmaAdapter
);
6148 (NTAPI
*PREAD_DMA_COUNTER
)(
6149 _In_ PDMA_ADAPTER DmaAdapter
);
6151 _Function_class_(DRIVER_LIST_CONTROL
)
6152 _IRQL_requires_same_
6154 (NTAPI DRIVER_LIST_CONTROL
)(
6155 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
6156 _In_
struct _IRP
*Irp
,
6157 _In_
struct _SCATTER_GATHER_LIST
*ScatterGather
,
6158 _In_ PVOID Context
);
6159 typedef DRIVER_LIST_CONTROL
*PDRIVER_LIST_CONTROL
;
6162 (NTAPI
*PGET_SCATTER_GATHER_LIST
)(
6163 _In_ PDMA_ADAPTER DmaAdapter
,
6164 _In_ PDEVICE_OBJECT DeviceObject
,
6166 _In_ PVOID CurrentVa
,
6168 _In_ PDRIVER_LIST_CONTROL ExecutionRoutine
,
6170 _In_ BOOLEAN WriteToDevice
);
6173 (NTAPI
*PPUT_SCATTER_GATHER_LIST
)(
6174 _In_ PDMA_ADAPTER DmaAdapter
,
6175 _In_ PSCATTER_GATHER_LIST ScatterGather
,
6176 _In_ BOOLEAN WriteToDevice
);
6179 (NTAPI
*PCALCULATE_SCATTER_GATHER_LIST_SIZE
)(
6180 _In_ PDMA_ADAPTER DmaAdapter
,
6181 _In_ PMDL Mdl OPTIONAL
,
6182 _In_ PVOID CurrentVa
,
6184 _Out_ PULONG ScatterGatherListSize
,
6185 _Out_ OPTIONAL PULONG pNumberOfMapRegisters
);
6188 (NTAPI
*PBUILD_SCATTER_GATHER_LIST
)(
6189 _In_ PDMA_ADAPTER DmaAdapter
,
6190 _In_ PDEVICE_OBJECT DeviceObject
,
6192 _In_ PVOID CurrentVa
,
6194 _In_ PDRIVER_LIST_CONTROL ExecutionRoutine
,
6196 _In_ BOOLEAN WriteToDevice
,
6197 _In_ PVOID ScatterGatherBuffer
,
6198 _In_ ULONG ScatterGatherLength
);
6201 (NTAPI
*PBUILD_MDL_FROM_SCATTER_GATHER_LIST
)(
6202 _In_ PDMA_ADAPTER DmaAdapter
,
6203 _In_ PSCATTER_GATHER_LIST ScatterGather
,
6204 _In_ PMDL OriginalMdl
,
6205 _Out_ PMDL
*TargetMdl
);
6207 typedef struct _DMA_OPERATIONS
{
6209 PPUT_DMA_ADAPTER PutDmaAdapter
;
6210 PALLOCATE_COMMON_BUFFER AllocateCommonBuffer
;
6211 PFREE_COMMON_BUFFER FreeCommonBuffer
;
6212 PALLOCATE_ADAPTER_CHANNEL AllocateAdapterChannel
;
6213 PFLUSH_ADAPTER_BUFFERS FlushAdapterBuffers
;
6214 PFREE_ADAPTER_CHANNEL FreeAdapterChannel
;
6215 PFREE_MAP_REGISTERS FreeMapRegisters
;
6216 PMAP_TRANSFER MapTransfer
;
6217 PGET_DMA_ALIGNMENT GetDmaAlignment
;
6218 PREAD_DMA_COUNTER ReadDmaCounter
;
6219 PGET_SCATTER_GATHER_LIST GetScatterGatherList
;
6220 PPUT_SCATTER_GATHER_LIST PutScatterGatherList
;
6221 PCALCULATE_SCATTER_GATHER_LIST_SIZE CalculateScatterGatherList
;
6222 PBUILD_SCATTER_GATHER_LIST BuildScatterGatherList
;
6223 PBUILD_MDL_FROM_SCATTER_GATHER_LIST BuildMdlFromScatterGatherList
;
6224 } DMA_OPERATIONS
, *PDMA_OPERATIONS
;
6226 typedef struct _IO_RESOURCE_DESCRIPTOR
{
6229 UCHAR ShareDisposition
;
6237 PHYSICAL_ADDRESS MinimumAddress
;
6238 PHYSICAL_ADDRESS MaximumAddress
;
6243 PHYSICAL_ADDRESS MinimumAddress
;
6244 PHYSICAL_ADDRESS MaximumAddress
;
6247 ULONG MinimumVector
;
6248 ULONG MaximumVector
;
6251 ULONG MinimumChannel
;
6252 ULONG MaximumChannel
;
6257 PHYSICAL_ADDRESS MinimumAddress
;
6258 PHYSICAL_ADDRESS MaximumAddress
;
6275 } IO_RESOURCE_DESCRIPTOR
, *PIO_RESOURCE_DESCRIPTOR
;
6277 typedef struct _IO_RESOURCE_LIST
{
6281 IO_RESOURCE_DESCRIPTOR Descriptors
[1];
6282 } IO_RESOURCE_LIST
, *PIO_RESOURCE_LIST
;
6284 typedef struct _IO_RESOURCE_REQUIREMENTS_LIST
{
6286 INTERFACE_TYPE InterfaceType
;
6290 ULONG AlternativeLists
;
6291 IO_RESOURCE_LIST List
[1];
6292 } IO_RESOURCE_REQUIREMENTS_LIST
, *PIO_RESOURCE_REQUIREMENTS_LIST
;
6294 _Function_class_(DRIVER_CANCEL
)
6295 _Requires_lock_held_(_Global_cancel_spin_lock_
)
6296 _Releases_lock_(_Global_cancel_spin_lock_
)
6297 _IRQL_requires_min_(DISPATCH_LEVEL
)
6298 _IRQL_requires_(DISPATCH_LEVEL
)
6300 (NTAPI DRIVER_CANCEL
)(
6301 _Inout_
struct _DEVICE_OBJECT
*DeviceObject
,
6302 _Inout_ _IRQL_uses_cancel_
struct _IRP
*Irp
);
6303 typedef DRIVER_CANCEL
*PDRIVER_CANCEL
;
6305 typedef struct DECLSPEC_ALIGN(MEMORY_ALLOCATION_ALIGNMENT
) _IRP
{
6308 struct _MDL
*MdlAddress
;
6311 struct _IRP
*MasterIrp
;
6312 volatile LONG IrpCount
;
6315 LIST_ENTRY ThreadListEntry
;
6316 IO_STATUS_BLOCK IoStatus
;
6317 KPROCESSOR_MODE RequestorMode
;
6318 BOOLEAN PendingReturned
;
6320 CHAR CurrentLocation
;
6323 CCHAR ApcEnvironment
;
6324 UCHAR AllocationFlags
;
6325 PIO_STATUS_BLOCK UserIosb
;
6329 _ANONYMOUS_UNION
union {
6330 PIO_APC_ROUTINE UserApcRoutine
;
6331 PVOID IssuingProcess
;
6333 PVOID UserApcContext
;
6334 } AsynchronousParameters
;
6335 LARGE_INTEGER AllocationSize
;
6337 volatile PDRIVER_CANCEL CancelRoutine
;
6341 _ANONYMOUS_UNION
union {
6342 KDEVICE_QUEUE_ENTRY DeviceQueueEntry
;
6343 _ANONYMOUS_STRUCT
struct {
6344 PVOID DriverContext
[4];
6348 PCHAR AuxiliaryBuffer
;
6349 _ANONYMOUS_STRUCT
struct {
6350 LIST_ENTRY ListEntry
;
6351 _ANONYMOUS_UNION
union {
6352 struct _IO_STACK_LOCATION
*CurrentStackLocation
;
6356 struct _FILE_OBJECT
*OriginalFileObject
;
6359 PVOID CompletionKey
;
6363 typedef enum _IO_PAGING_PRIORITY
{
6364 IoPagingPriorityInvalid
,
6365 IoPagingPriorityNormal
,
6366 IoPagingPriorityHigh
,
6367 IoPagingPriorityReserved1
,
6368 IoPagingPriorityReserved2
6369 } IO_PAGING_PRIORITY
;
6371 _Function_class_(IO_COMPLETION_ROUTINE
)
6372 _IRQL_requires_same_
6374 (NTAPI IO_COMPLETION_ROUTINE
)(
6375 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
6376 _In_
struct _IRP
*Irp
,
6377 _In_opt_ PVOID Context
);
6378 typedef IO_COMPLETION_ROUTINE
*PIO_COMPLETION_ROUTINE
;
6380 _Function_class_(IO_DPC_ROUTINE
)
6381 _IRQL_always_function_min_(DISPATCH_LEVEL
)
6382 _IRQL_requires_(DISPATCH_LEVEL
)
6383 _IRQL_requires_same_
6385 (NTAPI IO_DPC_ROUTINE
)(
6386 _In_
struct _KDPC
*Dpc
,
6387 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
6388 _Inout_
struct _IRP
*Irp
,
6389 _In_opt_ PVOID Context
);
6390 typedef IO_DPC_ROUTINE
*PIO_DPC_ROUTINE
;
6393 (NTAPI
*PMM_DLL_INITIALIZE
)(
6394 _In_ PUNICODE_STRING RegistryPath
);
6397 (NTAPI
*PMM_DLL_UNLOAD
)(
6400 _Function_class_(IO_TIMER_ROUTINE
)
6401 _IRQL_requires_same_
6403 (NTAPI IO_TIMER_ROUTINE
)(
6404 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
6405 _In_opt_ PVOID Context
);
6406 typedef IO_TIMER_ROUTINE
*PIO_TIMER_ROUTINE
;
6408 typedef struct _IO_SECURITY_CONTEXT
{
6409 PSECURITY_QUALITY_OF_SERVICE SecurityQos
;
6410 PACCESS_STATE AccessState
;
6411 ACCESS_MASK DesiredAccess
;
6412 ULONG FullCreateOptions
;
6413 } IO_SECURITY_CONTEXT
, *PIO_SECURITY_CONTEXT
;
6417 typedef struct _IO_CSQ_IRP_CONTEXT
{
6420 struct _IO_CSQ
*Csq
;
6421 } IO_CSQ_IRP_CONTEXT
, *PIO_CSQ_IRP_CONTEXT
;
6424 (NTAPI
*PIO_CSQ_INSERT_IRP
)(
6425 _In_
struct _IO_CSQ
*Csq
,
6429 (NTAPI IO_CSQ_INSERT_IRP_EX
)(
6430 _In_
struct _IO_CSQ
*Csq
,
6432 _In_ PVOID InsertContext
);
6433 typedef IO_CSQ_INSERT_IRP_EX
*PIO_CSQ_INSERT_IRP_EX
;
6436 (NTAPI
*PIO_CSQ_REMOVE_IRP
)(
6437 _In_
struct _IO_CSQ
*Csq
,
6441 (NTAPI
*PIO_CSQ_PEEK_NEXT_IRP
)(
6442 _In_
struct _IO_CSQ
*Csq
,
6444 _In_ PVOID PeekContext
);
6447 (NTAPI
*PIO_CSQ_ACQUIRE_LOCK
)(
6448 _In_
struct _IO_CSQ
*Csq
,
6452 (NTAPI
*PIO_CSQ_RELEASE_LOCK
)(
6453 _In_
struct _IO_CSQ
*Csq
,
6457 (NTAPI
*PIO_CSQ_COMPLETE_CANCELED_IRP
)(
6458 _In_
struct _IO_CSQ
*Csq
,
6461 typedef struct _IO_CSQ
{
6463 PIO_CSQ_INSERT_IRP CsqInsertIrp
;
6464 PIO_CSQ_REMOVE_IRP CsqRemoveIrp
;
6465 PIO_CSQ_PEEK_NEXT_IRP CsqPeekNextIrp
;
6466 PIO_CSQ_ACQUIRE_LOCK CsqAcquireLock
;
6467 PIO_CSQ_RELEASE_LOCK CsqReleaseLock
;
6468 PIO_CSQ_COMPLETE_CANCELED_IRP CsqCompleteCanceledIrp
;
6469 PVOID ReservePointer
;
6472 typedef enum _BUS_QUERY_ID_TYPE
{
6474 BusQueryHardwareIDs
,
6475 BusQueryCompatibleIDs
,
6477 BusQueryDeviceSerialNumber
6478 } BUS_QUERY_ID_TYPE
, *PBUS_QUERY_ID_TYPE
;
6480 typedef enum _DEVICE_TEXT_TYPE
{
6481 DeviceTextDescription
,
6482 DeviceTextLocationInformation
6483 } DEVICE_TEXT_TYPE
, *PDEVICE_TEXT_TYPE
;
6486 (NTAPI
*PGPE_SERVICE_ROUTINE
)(
6490 _IRQL_requires_max_(DISPATCH_LEVEL
)
6491 _Must_inspect_result_
6493 (NTAPI
*PGPE_CONNECT_VECTOR
)(
6498 PGPE_SERVICE_ROUTINE
,
6502 _IRQL_requires_max_(DISPATCH_LEVEL
)
6503 _Must_inspect_result_
6505 (NTAPI
*PGPE_DISCONNECT_VECTOR
)(
6508 _IRQL_requires_max_(DISPATCH_LEVEL
)
6509 _Must_inspect_result_
6511 (NTAPI
*PGPE_ENABLE_EVENT
)(
6515 _IRQL_requires_max_(DISPATCH_LEVEL
)
6516 _Must_inspect_result_
6518 (NTAPI
*PGPE_DISABLE_EVENT
)(
6522 _IRQL_requires_max_(DISPATCH_LEVEL
)
6523 _Must_inspect_result_
6525 (NTAPI
*PGPE_CLEAR_STATUS
)(
6530 (NTAPI
*PDEVICE_NOTIFY_CALLBACK
)(
6534 _IRQL_requires_max_(DISPATCH_LEVEL
)
6535 _Must_inspect_result_
6537 (NTAPI
*PREGISTER_FOR_DEVICE_NOTIFICATIONS
)(
6539 PDEVICE_NOTIFY_CALLBACK
,
6542 _IRQL_requires_max_(DISPATCH_LEVEL
)
6544 (NTAPI
*PUNREGISTER_FOR_DEVICE_NOTIFICATIONS
)(
6546 PDEVICE_NOTIFY_CALLBACK
);
6548 typedef struct _ACPI_INTERFACE_STANDARD
{
6552 PINTERFACE_REFERENCE InterfaceReference
;
6553 PINTERFACE_DEREFERENCE InterfaceDereference
;
6554 PGPE_CONNECT_VECTOR GpeConnectVector
;
6555 PGPE_DISCONNECT_VECTOR GpeDisconnectVector
;
6556 PGPE_ENABLE_EVENT GpeEnableEvent
;
6557 PGPE_DISABLE_EVENT GpeDisableEvent
;
6558 PGPE_CLEAR_STATUS GpeClearStatus
;
6559 PREGISTER_FOR_DEVICE_NOTIFICATIONS RegisterForDeviceNotifications
;
6560 PUNREGISTER_FOR_DEVICE_NOTIFICATIONS UnregisterForDeviceNotifications
;
6561 } ACPI_INTERFACE_STANDARD
, *PACPI_INTERFACE_STANDARD
;
6564 (NTAPI
*PGPE_SERVICE_ROUTINE2
)(
6565 PVOID ObjectContext
,
6566 PVOID ServiceContext
);
6568 _IRQL_requires_max_(DISPATCH_LEVEL
)
6569 _Must_inspect_result_
6571 (NTAPI
*PGPE_CONNECT_VECTOR2
)(
6574 KINTERRUPT_MODE Mode
,
6576 PGPE_SERVICE_ROUTINE ServiceRoutine
,
6577 PVOID ServiceContext
,
6578 PVOID
*ObjectContext
);
6580 _IRQL_requires_max_(DISPATCH_LEVEL
)
6581 _Must_inspect_result_
6583 (NTAPI
*PGPE_DISCONNECT_VECTOR2
)(
6585 PVOID ObjectContext
);
6587 _IRQL_requires_max_(DISPATCH_LEVEL
)
6588 _Must_inspect_result_
6590 (NTAPI
*PGPE_ENABLE_EVENT2
)(
6592 PVOID ObjectContext
);
6594 _IRQL_requires_max_(DISPATCH_LEVEL
)
6595 _Must_inspect_result_
6597 (NTAPI
*PGPE_DISABLE_EVENT2
)(
6599 PVOID ObjectContext
);
6601 _IRQL_requires_max_(DISPATCH_LEVEL
)
6602 _Must_inspect_result_
6604 (NTAPI
*PGPE_CLEAR_STATUS2
)(
6606 PVOID ObjectContext
);
6608 _IRQL_requires_max_(DISPATCH_LEVEL
)
6610 (NTAPI
*PDEVICE_NOTIFY_CALLBACK2
)(
6611 PVOID NotificationContext
,
6614 _IRQL_requires_max_(DISPATCH_LEVEL
)
6615 _Must_inspect_result_
6617 (NTAPI
*PREGISTER_FOR_DEVICE_NOTIFICATIONS2
)(
6619 PDEVICE_NOTIFY_CALLBACK2 NotificationHandler
,
6620 PVOID NotificationContext
);
6622 _IRQL_requires_max_(DISPATCH_LEVEL
)
6624 (NTAPI
*PUNREGISTER_FOR_DEVICE_NOTIFICATIONS2
)(
6627 typedef struct _ACPI_INTERFACE_STANDARD2
{
6631 PINTERFACE_REFERENCE InterfaceReference
;
6632 PINTERFACE_DEREFERENCE InterfaceDereference
;
6633 PGPE_CONNECT_VECTOR2 GpeConnectVector
;
6634 PGPE_DISCONNECT_VECTOR2 GpeDisconnectVector
;
6635 PGPE_ENABLE_EVENT2 GpeEnableEvent
;
6636 PGPE_DISABLE_EVENT2 GpeDisableEvent
;
6637 PGPE_CLEAR_STATUS2 GpeClearStatus
;
6638 PREGISTER_FOR_DEVICE_NOTIFICATIONS2 RegisterForDeviceNotifications
;
6639 PUNREGISTER_FOR_DEVICE_NOTIFICATIONS2 UnregisterForDeviceNotifications
;
6640 } ACPI_INTERFACE_STANDARD2
, *PACPI_INTERFACE_STANDARD2
;
6642 #if !defined(_AMD64_) && !defined(_IA64_)
6643 #include <pshpack4.h>
6645 typedef struct _IO_STACK_LOCATION
{
6646 UCHAR MajorFunction
;
6647 UCHAR MinorFunction
;
6652 PIO_SECURITY_CONTEXT SecurityContext
;
6654 USHORT POINTER_ALIGNMENT FileAttributes
;
6656 ULONG POINTER_ALIGNMENT EaLength
;
6660 ULONG POINTER_ALIGNMENT Key
;
6661 LARGE_INTEGER ByteOffset
;
6665 ULONG POINTER_ALIGNMENT Key
;
6666 LARGE_INTEGER ByteOffset
;
6670 PUNICODE_STRING FileName
;
6671 FILE_INFORMATION_CLASS FileInformationClass
;
6676 ULONG CompletionFilter
;
6680 FILE_INFORMATION_CLASS POINTER_ALIGNMENT FileInformationClass
;
6684 FILE_INFORMATION_CLASS POINTER_ALIGNMENT FileInformationClass
;
6685 PFILE_OBJECT FileObject
;
6686 _ANONYMOUS_UNION
union {
6687 _ANONYMOUS_STRUCT
struct {
6688 BOOLEAN ReplaceIfExists
;
6689 BOOLEAN AdvanceOnly
;
6692 HANDLE DeleteHandle
;
6706 FS_INFORMATION_CLASS POINTER_ALIGNMENT FsInformationClass
;
6710 FS_INFORMATION_CLASS FsInformationClass
;
6713 ULONG OutputBufferLength
;
6714 ULONG InputBufferLength
;
6715 ULONG FsControlCode
;
6716 PVOID Type3InputBuffer
;
6717 } FileSystemControl
;
6719 PLARGE_INTEGER Length
;
6721 LARGE_INTEGER ByteOffset
;
6724 ULONG OutputBufferLength
;
6725 ULONG POINTER_ALIGNMENT InputBufferLength
;
6726 ULONG POINTER_ALIGNMENT IoControlCode
;
6727 PVOID Type3InputBuffer
;
6730 SECURITY_INFORMATION SecurityInformation
;
6731 ULONG POINTER_ALIGNMENT Length
;
6734 SECURITY_INFORMATION SecurityInformation
;
6735 PSECURITY_DESCRIPTOR SecurityDescriptor
;
6739 PDEVICE_OBJECT DeviceObject
;
6743 PDEVICE_OBJECT DeviceObject
;
6746 struct _SCSI_REQUEST_BLOCK
*Srb
;
6751 struct _FILE_GET_QUOTA_INFORMATION
*SidList
;
6752 ULONG SidListLength
;
6758 DEVICE_RELATION_TYPE Type
;
6759 } QueryDeviceRelations
;
6761 CONST GUID
*InterfaceType
;
6764 PINTERFACE Interface
;
6765 PVOID InterfaceSpecificData
;
6768 PDEVICE_CAPABILITIES Capabilities
;
6769 } DeviceCapabilities
;
6771 PIO_RESOURCE_REQUIREMENTS_LIST IoResourceRequirementList
;
6772 } FilterResourceRequirements
;
6777 ULONG POINTER_ALIGNMENT Length
;
6783 BUS_QUERY_ID_TYPE IdType
;
6786 DEVICE_TEXT_TYPE DeviceTextType
;
6787 LCID POINTER_ALIGNMENT LocaleId
;
6791 BOOLEAN Reserved
[3];
6792 DEVICE_USAGE_NOTIFICATION_TYPE POINTER_ALIGNMENT Type
;
6793 } UsageNotification
;
6795 SYSTEM_POWER_STATE PowerState
;
6798 PPOWER_SEQUENCE PowerSequence
;
6801 ULONG SystemContext
;
6802 POWER_STATE_TYPE POINTER_ALIGNMENT Type
;
6803 POWER_STATE POINTER_ALIGNMENT State
;
6804 POWER_ACTION POINTER_ALIGNMENT ShutdownType
;
6807 PCM_RESOURCE_LIST AllocatedResources
;
6808 PCM_RESOURCE_LIST AllocatedResourcesTranslated
;
6811 ULONG_PTR ProviderId
;
6823 PDEVICE_OBJECT DeviceObject
;
6824 PFILE_OBJECT FileObject
;
6825 PIO_COMPLETION_ROUTINE CompletionRoutine
;
6827 } IO_STACK_LOCATION
, *PIO_STACK_LOCATION
;
6828 #if !defined(_AMD64_) && !defined(_IA64_)
6829 #include <poppack.h>
6832 /* IO_STACK_LOCATION.Control */
6834 #define SL_PENDING_RETURNED 0x01
6835 #define SL_ERROR_RETURNED 0x02
6836 #define SL_INVOKE_ON_CANCEL 0x20
6837 #define SL_INVOKE_ON_SUCCESS 0x40
6838 #define SL_INVOKE_ON_ERROR 0x80
6840 #define METHOD_BUFFERED 0
6841 #define METHOD_IN_DIRECT 1
6842 #define METHOD_OUT_DIRECT 2
6843 #define METHOD_NEITHER 3
6845 #define METHOD_DIRECT_TO_HARDWARE METHOD_IN_DIRECT
6846 #define METHOD_DIRECT_FROM_HARDWARE METHOD_OUT_DIRECT
6848 #define FILE_SUPERSEDED 0x00000000
6849 #define FILE_OPENED 0x00000001
6850 #define FILE_CREATED 0x00000002
6851 #define FILE_OVERWRITTEN 0x00000003
6852 #define FILE_EXISTS 0x00000004
6853 #define FILE_DOES_NOT_EXIST 0x00000005
6855 #define FILE_USE_FILE_POINTER_POSITION 0xfffffffe
6856 #define FILE_WRITE_TO_END_OF_FILE 0xffffffff
6858 /* also in winnt.h */
6859 #define FILE_LIST_DIRECTORY 0x00000001
6860 #define FILE_READ_DATA 0x00000001
6861 #define FILE_ADD_FILE 0x00000002
6862 #define FILE_WRITE_DATA 0x00000002
6863 #define FILE_ADD_SUBDIRECTORY 0x00000004
6864 #define FILE_APPEND_DATA 0x00000004
6865 #define FILE_CREATE_PIPE_INSTANCE 0x00000004
6866 #define FILE_READ_EA 0x00000008
6867 #define FILE_WRITE_EA 0x00000010
6868 #define FILE_EXECUTE 0x00000020
6869 #define FILE_TRAVERSE 0x00000020
6870 #define FILE_DELETE_CHILD 0x00000040
6871 #define FILE_READ_ATTRIBUTES 0x00000080
6872 #define FILE_WRITE_ATTRIBUTES 0x00000100
6874 #define FILE_SHARE_READ 0x00000001
6875 #define FILE_SHARE_WRITE 0x00000002
6876 #define FILE_SHARE_DELETE 0x00000004
6877 #define FILE_SHARE_VALID_FLAGS 0x00000007
6879 #define FILE_ATTRIBUTE_READONLY 0x00000001
6880 #define FILE_ATTRIBUTE_HIDDEN 0x00000002
6881 #define FILE_ATTRIBUTE_SYSTEM 0x00000004
6882 #define FILE_ATTRIBUTE_DIRECTORY 0x00000010
6883 #define FILE_ATTRIBUTE_ARCHIVE 0x00000020
6884 #define FILE_ATTRIBUTE_DEVICE 0x00000040
6885 #define FILE_ATTRIBUTE_NORMAL 0x00000080
6886 #define FILE_ATTRIBUTE_TEMPORARY 0x00000100
6887 #define FILE_ATTRIBUTE_SPARSE_FILE 0x00000200
6888 #define FILE_ATTRIBUTE_REPARSE_POINT 0x00000400
6889 #define FILE_ATTRIBUTE_COMPRESSED 0x00000800
6890 #define FILE_ATTRIBUTE_OFFLINE 0x00001000
6891 #define FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 0x00002000
6892 #define FILE_ATTRIBUTE_ENCRYPTED 0x00004000
6893 #define FILE_ATTRIBUTE_VIRTUAL 0x00010000
6895 #define FILE_ATTRIBUTE_VALID_FLAGS 0x00007fb7
6896 #define FILE_ATTRIBUTE_VALID_SET_FLAGS 0x000031a7
6898 #define FILE_VALID_OPTION_FLAGS 0x00ffffff
6899 #define FILE_VALID_PIPE_OPTION_FLAGS 0x00000032
6900 #define FILE_VALID_MAILSLOT_OPTION_FLAGS 0x00000032
6901 #define FILE_VALID_SET_FLAGS 0x00000036
6903 #define FILE_SUPERSEDE 0x00000000
6904 #define FILE_OPEN 0x00000001
6905 #define FILE_CREATE 0x00000002
6906 #define FILE_OPEN_IF 0x00000003
6907 #define FILE_OVERWRITE 0x00000004
6908 #define FILE_OVERWRITE_IF 0x00000005
6909 #define FILE_MAXIMUM_DISPOSITION 0x00000005
6911 #define FILE_DIRECTORY_FILE 0x00000001
6912 #define FILE_WRITE_THROUGH 0x00000002
6913 #define FILE_SEQUENTIAL_ONLY 0x00000004
6914 #define FILE_NO_INTERMEDIATE_BUFFERING 0x00000008
6915 #define FILE_SYNCHRONOUS_IO_ALERT 0x00000010
6916 #define FILE_SYNCHRONOUS_IO_NONALERT 0x00000020
6917 #define FILE_NON_DIRECTORY_FILE 0x00000040
6918 #define FILE_CREATE_TREE_CONNECTION 0x00000080
6919 #define FILE_COMPLETE_IF_OPLOCKED 0x00000100
6920 #define FILE_NO_EA_KNOWLEDGE 0x00000200
6921 #define FILE_OPEN_REMOTE_INSTANCE 0x00000400
6922 #define FILE_RANDOM_ACCESS 0x00000800
6923 #define FILE_DELETE_ON_CLOSE 0x00001000
6924 #define FILE_OPEN_BY_FILE_ID 0x00002000
6925 #define FILE_OPEN_FOR_BACKUP_INTENT 0x00004000
6926 #define FILE_NO_COMPRESSION 0x00008000
6927 #if (NTDDI_VERSION >= NTDDI_WIN7)
6928 #define FILE_OPEN_REQUIRING_OPLOCK 0x00010000
6929 #define FILE_DISALLOW_EXCLUSIVE 0x00020000
6930 #endif /* (NTDDI_VERSION >= NTDDI_WIN7) */
6931 #define FILE_RESERVE_OPFILTER 0x00100000
6932 #define FILE_OPEN_REPARSE_POINT 0x00200000
6933 #define FILE_OPEN_NO_RECALL 0x00400000
6934 #define FILE_OPEN_FOR_FREE_SPACE_QUERY 0x00800000
6936 #define FILE_ANY_ACCESS 0x00000000
6937 #define FILE_SPECIAL_ACCESS FILE_ANY_ACCESS
6938 #define FILE_READ_ACCESS 0x00000001
6939 #define FILE_WRITE_ACCESS 0x00000002
6941 #define FILE_ALL_ACCESS \
6942 (STANDARD_RIGHTS_REQUIRED | \
6946 #define FILE_GENERIC_EXECUTE \
6947 (STANDARD_RIGHTS_EXECUTE | \
6948 FILE_READ_ATTRIBUTES | \
6952 #define FILE_GENERIC_READ \
6953 (STANDARD_RIGHTS_READ | \
6955 FILE_READ_ATTRIBUTES | \
6959 #define FILE_GENERIC_WRITE \
6960 (STANDARD_RIGHTS_WRITE | \
6962 FILE_WRITE_ATTRIBUTES | \
6964 FILE_APPEND_DATA | \
6969 #define WMIREG_ACTION_REGISTER 1
6970 #define WMIREG_ACTION_DEREGISTER 2
6971 #define WMIREG_ACTION_REREGISTER 3
6972 #define WMIREG_ACTION_UPDATE_GUIDS 4
6973 #define WMIREG_ACTION_BLOCK_IRPS 5
6975 #define WMIREGISTER 0
6978 _Function_class_(WMI_NOTIFICATION_CALLBACK
)
6979 _IRQL_requires_same_
6981 (NTAPI FWMI_NOTIFICATION_CALLBACK
)(
6984 typedef FWMI_NOTIFICATION_CALLBACK
*WMI_NOTIFICATION_CALLBACK
;
6989 typedef struct _PCI_SLOT_NUMBER
{
6992 ULONG DeviceNumber
:5;
6993 ULONG FunctionNumber
:3;
6998 } PCI_SLOT_NUMBER
, *PPCI_SLOT_NUMBER
;
7000 #define PCI_TYPE0_ADDRESSES 6
7001 #define PCI_TYPE1_ADDRESSES 2
7002 #define PCI_TYPE2_ADDRESSES 5
7004 typedef struct _PCI_COMMON_HEADER
{
7005 PCI_COMMON_HEADER_LAYOUT
7006 } PCI_COMMON_HEADER
, *PPCI_COMMON_HEADER
;
7009 typedef struct _PCI_COMMON_CONFIG
{
7010 PCI_COMMON_HEADER_LAYOUT
7011 UCHAR DeviceSpecific
[192];
7012 } PCI_COMMON_CONFIG
, *PPCI_COMMON_CONFIG
;
7014 typedef struct _PCI_COMMON_CONFIG
{
7015 PCI_COMMON_HEADER DUMMYSTRUCTNAME
;
7016 UCHAR DeviceSpecific
[192];
7017 } PCI_COMMON_CONFIG
, *PPCI_COMMON_CONFIG
;
7020 #define PCI_COMMON_HDR_LENGTH (FIELD_OFFSET(PCI_COMMON_CONFIG, DeviceSpecific))
7022 #define PCI_EXTENDED_CONFIG_LENGTH 0x1000
7024 #define PCI_MAX_DEVICES 32
7025 #define PCI_MAX_FUNCTION 8
7026 #define PCI_MAX_BRIDGE_NUMBER 0xFF
7027 #define PCI_INVALID_VENDORID 0xFFFF
7029 /* PCI_COMMON_CONFIG.HeaderType */
7030 #define PCI_MULTIFUNCTION 0x80
7031 #define PCI_DEVICE_TYPE 0x00
7032 #define PCI_BRIDGE_TYPE 0x01
7033 #define PCI_CARDBUS_BRIDGE_TYPE 0x02
7035 #define PCI_CONFIGURATION_TYPE(PciData) \
7036 (((PPCI_COMMON_CONFIG) (PciData))->HeaderType & ~PCI_MULTIFUNCTION)
7038 #define PCI_MULTIFUNCTION_DEVICE(PciData) \
7039 ((((PPCI_COMMON_CONFIG) (PciData))->HeaderType & PCI_MULTIFUNCTION) != 0)
7041 /* PCI_COMMON_CONFIG.Command */
7042 #define PCI_ENABLE_IO_SPACE 0x0001
7043 #define PCI_ENABLE_MEMORY_SPACE 0x0002
7044 #define PCI_ENABLE_BUS_MASTER 0x0004
7045 #define PCI_ENABLE_SPECIAL_CYCLES 0x0008
7046 #define PCI_ENABLE_WRITE_AND_INVALIDATE 0x0010
7047 #define PCI_ENABLE_VGA_COMPATIBLE_PALETTE 0x0020
7048 #define PCI_ENABLE_PARITY 0x0040
7049 #define PCI_ENABLE_WAIT_CYCLE 0x0080
7050 #define PCI_ENABLE_SERR 0x0100
7051 #define PCI_ENABLE_FAST_BACK_TO_BACK 0x0200
7052 #define PCI_DISABLE_LEVEL_INTERRUPT 0x0400
7054 /* PCI_COMMON_CONFIG.Status */
7055 #define PCI_STATUS_INTERRUPT_PENDING 0x0008
7056 #define PCI_STATUS_CAPABILITIES_LIST 0x0010
7057 #define PCI_STATUS_66MHZ_CAPABLE 0x0020
7058 #define PCI_STATUS_UDF_SUPPORTED 0x0040
7059 #define PCI_STATUS_FAST_BACK_TO_BACK 0x0080
7060 #define PCI_STATUS_DATA_PARITY_DETECTED 0x0100
7061 #define PCI_STATUS_DEVSEL 0x0600
7062 #define PCI_STATUS_SIGNALED_TARGET_ABORT 0x0800
7063 #define PCI_STATUS_RECEIVED_TARGET_ABORT 0x1000
7064 #define PCI_STATUS_RECEIVED_MASTER_ABORT 0x2000
7065 #define PCI_STATUS_SIGNALED_SYSTEM_ERROR 0x4000
7066 #define PCI_STATUS_DETECTED_PARITY_ERROR 0x8000
7068 /* IO_STACK_LOCATION.Parameters.ReadWriteControl.WhichSpace */
7070 #define PCI_WHICHSPACE_CONFIG 0x0
7071 #define PCI_WHICHSPACE_ROM 0x52696350 /* 'PciR' */
7073 #define PCI_CAPABILITY_ID_POWER_MANAGEMENT 0x01
7074 #define PCI_CAPABILITY_ID_AGP 0x02
7075 #define PCI_CAPABILITY_ID_VPD 0x03
7076 #define PCI_CAPABILITY_ID_SLOT_ID 0x04
7077 #define PCI_CAPABILITY_ID_MSI 0x05
7078 #define PCI_CAPABILITY_ID_CPCI_HOTSWAP 0x06
7079 #define PCI_CAPABILITY_ID_PCIX 0x07
7080 #define PCI_CAPABILITY_ID_HYPERTRANSPORT 0x08
7081 #define PCI_CAPABILITY_ID_VENDOR_SPECIFIC 0x09
7082 #define PCI_CAPABILITY_ID_DEBUG_PORT 0x0A
7083 #define PCI_CAPABILITY_ID_CPCI_RES_CTRL 0x0B
7084 #define PCI_CAPABILITY_ID_SHPC 0x0C
7085 #define PCI_CAPABILITY_ID_P2P_SSID 0x0D
7086 #define PCI_CAPABILITY_ID_AGP_TARGET 0x0E
7087 #define PCI_CAPABILITY_ID_SECURE 0x0F
7088 #define PCI_CAPABILITY_ID_PCI_EXPRESS 0x10
7089 #define PCI_CAPABILITY_ID_MSIX 0x11
7091 typedef struct _PCI_CAPABILITIES_HEADER
{
7094 } PCI_CAPABILITIES_HEADER
, *PPCI_CAPABILITIES_HEADER
;
7096 typedef struct _PCI_PMC
{
7100 UCHAR DeviceSpecificInitialization
:1;
7102 struct _PM_SUPPORT
{
7112 } PCI_PMC
, *PPCI_PMC
;
7114 typedef struct _PCI_PMCSR
{
7115 USHORT PowerState
:2;
7118 USHORT DataSelect
:4;
7121 } PCI_PMCSR
, *PPCI_PMCSR
;
7123 typedef struct _PCI_PMCSR_BSE
{
7125 UCHAR D3HotSupportsStopClock
:1;
7126 UCHAR BusPowerClockControlEnabled
:1;
7127 } PCI_PMCSR_BSE
, *PPCI_PMCSR_BSE
;
7129 typedef struct _PCI_PM_CAPABILITY
{
7130 PCI_CAPABILITIES_HEADER Header
;
7132 PCI_PMC Capabilities
;
7136 PCI_PMCSR ControlStatus
;
7140 PCI_PMCSR_BSE BridgeSupport
;
7144 } PCI_PM_CAPABILITY
, *PPCI_PM_CAPABILITY
;
7147 PCI_CAPABILITIES_HEADER Header
;
7150 USHORT DataParityErrorRecoveryEnable
:1;
7151 USHORT EnableRelaxedOrdering
:1;
7152 USHORT MaxMemoryReadByteCount
:2;
7153 USHORT MaxOutstandingSplitTransactions
:3;
7160 ULONG FunctionNumber
:3;
7161 ULONG DeviceNumber
:5;
7163 ULONG Device64Bit
:1;
7164 ULONG Capable133MHz
:1;
7165 ULONG SplitCompletionDiscarded
:1;
7166 ULONG UnexpectedSplitCompletion
:1;
7167 ULONG DeviceComplexity
:1;
7168 ULONG DesignedMaxMemoryReadByteCount
:2;
7169 ULONG DesignedMaxOutstandingSplitTransactions
:3;
7170 ULONG DesignedMaxCumulativeReadSize
:3;
7171 ULONG ReceivedSplitCompletionErrorMessage
:1;
7172 ULONG CapablePCIX266
:1;
7173 ULONG CapablePCIX533
:1;
7177 } PCI_X_CAPABILITY
, *PPCI_X_CAPABILITY
;
7179 #define PCI_EXPRESS_ADVANCED_ERROR_REPORTING_CAP_ID 0x0001
7180 #define PCI_EXPRESS_VIRTUAL_CHANNEL_CAP_ID 0x0002
7181 #define PCI_EXPRESS_DEVICE_SERIAL_NUMBER_CAP_ID 0x0003
7182 #define PCI_EXPRESS_POWER_BUDGETING_CAP_ID 0x0004
7183 #define PCI_EXPRESS_RC_LINK_DECLARATION_CAP_ID 0x0005
7184 #define PCI_EXPRESS_RC_INTERNAL_LINK_CONTROL_CAP_ID 0x0006
7185 #define PCI_EXPRESS_RC_EVENT_COLLECTOR_ENDPOINT_ASSOCIATION_CAP_ID 0x0007
7186 #define PCI_EXPRESS_MFVC_CAP_ID 0x0008
7187 #define PCI_EXPRESS_VC_AND_MFVC_CAP_ID 0x0009
7188 #define PCI_EXPRESS_RCRB_HEADER_CAP_ID 0x000A
7189 #define PCI_EXPRESS_SINGLE_ROOT_IO_VIRTUALIZATION_CAP_ID 0x0010
7191 typedef struct _PCI_EXPRESS_ENHANCED_CAPABILITY_HEADER
{
7192 USHORT CapabilityID
;
7195 } PCI_EXPRESS_ENHANCED_CAPABILITY_HEADER
, *PPCI_EXPRESS_ENHANCED_CAPABILITY_HEADER
;
7197 typedef struct _PCI_EXPRESS_SERIAL_NUMBER_CAPABILITY
{
7198 PCI_EXPRESS_ENHANCED_CAPABILITY_HEADER Header
;
7199 ULONG LowSerialNumber
;
7200 ULONG HighSerialNumber
;
7201 } PCI_EXPRESS_SERIAL_NUMBER_CAPABILITY
, *PPCI_EXPRESS_SERIAL_NUMBER_CAPABILITY
;
7203 typedef union _PCI_EXPRESS_UNCORRECTABLE_ERROR_STATUS
{
7204 _ANONYMOUS_STRUCT
struct {
7207 ULONG DataLinkProtocolError
:1;
7208 ULONG SurpriseDownError
:1;
7210 ULONG PoisonedTLP
:1;
7211 ULONG FlowControlProtocolError
:1;
7212 ULONG CompletionTimeout
:1;
7213 ULONG CompleterAbort
:1;
7214 ULONG UnexpectedCompletion
:1;
7215 ULONG ReceiverOverflow
:1;
7216 ULONG MalformedTLP
:1;
7218 ULONG UnsupportedRequestError
:1;
7222 } PCI_EXPRESS_UNCORRECTABLE_ERROR_STATUS
, *PPCI_EXPRESS_UNCORRECTABLE_ERROR_STATUS
;
7224 typedef union _PCI_EXPRESS_UNCORRECTABLE_ERROR_MASK
{
7225 _ANONYMOUS_STRUCT
struct {
7228 ULONG DataLinkProtocolError
:1;
7229 ULONG SurpriseDownError
:1;
7231 ULONG PoisonedTLP
:1;
7232 ULONG FlowControlProtocolError
:1;
7233 ULONG CompletionTimeout
:1;
7234 ULONG CompleterAbort
:1;
7235 ULONG UnexpectedCompletion
:1;
7236 ULONG ReceiverOverflow
:1;
7237 ULONG MalformedTLP
:1;
7239 ULONG UnsupportedRequestError
:1;
7243 } PCI_EXPRESS_UNCORRECTABLE_ERROR_MASK
, *PPCI_EXPRESS_UNCORRECTABLE_ERROR_MASK
;
7245 typedef union _PCI_EXPRESS_UNCORRECTABLE_ERROR_SEVERITY
{
7246 _ANONYMOUS_STRUCT
struct {
7249 ULONG DataLinkProtocolError
:1;
7250 ULONG SurpriseDownError
:1;
7252 ULONG PoisonedTLP
:1;
7253 ULONG FlowControlProtocolError
:1;
7254 ULONG CompletionTimeout
:1;
7255 ULONG CompleterAbort
:1;
7256 ULONG UnexpectedCompletion
:1;
7257 ULONG ReceiverOverflow
:1;
7258 ULONG MalformedTLP
:1;
7260 ULONG UnsupportedRequestError
:1;
7264 } PCI_EXPRESS_UNCORRECTABLE_ERROR_SEVERITY
, *PPCI_EXPRESS_UNCORRECTABLE_ERROR_SEVERITY
;
7266 typedef union _PCI_EXPRESS_CORRECTABLE_ERROR_STATUS
{
7267 _ANONYMOUS_STRUCT
struct {
7268 ULONG ReceiverError
:1;
7272 ULONG ReplayNumRollover
:1;
7274 ULONG ReplayTimerTimeout
:1;
7275 ULONG AdvisoryNonFatalError
:1;
7279 } PCI_EXPRESS_CORRECTABLE_ERROR_STATUS
, *PPCI_CORRECTABLE_ERROR_STATUS
;
7281 typedef union _PCI_EXPRESS_CORRECTABLE_ERROR_MASK
{
7282 _ANONYMOUS_STRUCT
struct {
7283 ULONG ReceiverError
:1;
7287 ULONG ReplayNumRollover
:1;
7289 ULONG ReplayTimerTimeout
:1;
7290 ULONG AdvisoryNonFatalError
:1;
7294 } PCI_EXPRESS_CORRECTABLE_ERROR_MASK
, *PPCI_CORRECTABLE_ERROR_MASK
;
7296 typedef union _PCI_EXPRESS_AER_CAPABILITIES
{
7297 _ANONYMOUS_STRUCT
struct {
7298 ULONG FirstErrorPointer
:5;
7299 ULONG ECRCGenerationCapable
:1;
7300 ULONG ECRCGenerationEnable
:1;
7301 ULONG ECRCCheckCapable
:1;
7302 ULONG ECRCCheckEnable
:1;
7306 } PCI_EXPRESS_AER_CAPABILITIES
, *PPCI_EXPRESS_AER_CAPABILITIES
;
7308 typedef union _PCI_EXPRESS_ROOT_ERROR_COMMAND
{
7309 _ANONYMOUS_STRUCT
struct {
7310 ULONG CorrectableErrorReportingEnable
:1;
7311 ULONG NonFatalErrorReportingEnable
:1;
7312 ULONG FatalErrorReportingEnable
:1;
7316 } PCI_EXPRESS_ROOT_ERROR_COMMAND
, *PPCI_EXPRESS_ROOT_ERROR_COMMAND
;
7318 typedef union _PCI_EXPRESS_ROOT_ERROR_STATUS
{
7319 _ANONYMOUS_STRUCT
struct {
7320 ULONG CorrectableErrorReceived
:1;
7321 ULONG MultipleCorrectableErrorsReceived
:1;
7322 ULONG UncorrectableErrorReceived
:1;
7323 ULONG MultipleUncorrectableErrorsReceived
:1;
7324 ULONG FirstUncorrectableFatal
:1;
7325 ULONG NonFatalErrorMessagesReceived
:1;
7326 ULONG FatalErrorMessagesReceived
:1;
7328 ULONG AdvancedErrorInterruptMessageNumber
:5;
7331 } PCI_EXPRESS_ROOT_ERROR_STATUS
, *PPCI_EXPRESS_ROOT_ERROR_STATUS
;
7333 typedef union _PCI_EXPRESS_ERROR_SOURCE_ID
{
7334 _ANONYMOUS_STRUCT
struct {
7335 USHORT CorrectableSourceIdFun
:3;
7336 USHORT CorrectableSourceIdDev
:5;
7337 USHORT CorrectableSourceIdBus
:8;
7338 USHORT UncorrectableSourceIdFun
:3;
7339 USHORT UncorrectableSourceIdDev
:5;
7340 USHORT UncorrectableSourceIdBus
:8;
7343 } PCI_EXPRESS_ERROR_SOURCE_ID
, *PPCI_EXPRESS_ERROR_SOURCE_ID
;
7345 typedef union _PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_STATUS
{
7346 _ANONYMOUS_STRUCT
struct {
7347 ULONG TargetAbortOnSplitCompletion
:1;
7348 ULONG MasterAbortOnSplitCompletion
:1;
7349 ULONG ReceivedTargetAbort
:1;
7350 ULONG ReceivedMasterAbort
:1;
7352 ULONG UnexpectedSplitCompletionError
:1;
7353 ULONG UncorrectableSplitCompletion
:1;
7354 ULONG UncorrectableDataError
:1;
7355 ULONG UncorrectableAttributeError
:1;
7356 ULONG UncorrectableAddressError
:1;
7357 ULONG DelayedTransactionDiscardTimerExpired
:1;
7358 ULONG PERRAsserted
:1;
7359 ULONG SERRAsserted
:1;
7360 ULONG InternalBridgeError
:1;
7364 } PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_STATUS
, *PPCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_STATUS
;
7366 typedef union _PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_MASK
{
7367 _ANONYMOUS_STRUCT
struct {
7368 ULONG TargetAbortOnSplitCompletion
:1;
7369 ULONG MasterAbortOnSplitCompletion
:1;
7370 ULONG ReceivedTargetAbort
:1;
7371 ULONG ReceivedMasterAbort
:1;
7373 ULONG UnexpectedSplitCompletionError
:1;
7374 ULONG UncorrectableSplitCompletion
:1;
7375 ULONG UncorrectableDataError
:1;
7376 ULONG UncorrectableAttributeError
:1;
7377 ULONG UncorrectableAddressError
:1;
7378 ULONG DelayedTransactionDiscardTimerExpired
:1;
7379 ULONG PERRAsserted
:1;
7380 ULONG SERRAsserted
:1;
7381 ULONG InternalBridgeError
:1;
7385 } PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_MASK
, *PPCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_MASK
;
7387 typedef union _PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_SEVERITY
{
7388 _ANONYMOUS_STRUCT
struct {
7389 ULONG TargetAbortOnSplitCompletion
:1;
7390 ULONG MasterAbortOnSplitCompletion
:1;
7391 ULONG ReceivedTargetAbort
:1;
7392 ULONG ReceivedMasterAbort
:1;
7394 ULONG UnexpectedSplitCompletionError
:1;
7395 ULONG UncorrectableSplitCompletion
:1;
7396 ULONG UncorrectableDataError
:1;
7397 ULONG UncorrectableAttributeError
:1;
7398 ULONG UncorrectableAddressError
:1;
7399 ULONG DelayedTransactionDiscardTimerExpired
:1;
7400 ULONG PERRAsserted
:1;
7401 ULONG SERRAsserted
:1;
7402 ULONG InternalBridgeError
:1;
7406 } PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_SEVERITY
, *PPCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_SEVERITY
;
7408 typedef union _PCI_EXPRESS_SEC_AER_CAPABILITIES
{
7409 _ANONYMOUS_STRUCT
struct {
7410 ULONG SecondaryUncorrectableFirstErrorPtr
:5;
7414 } PCI_EXPRESS_SEC_AER_CAPABILITIES
, *PPCI_EXPRESS_SEC_AER_CAPABILITIES
;
7416 #define ROOT_CMD_ENABLE_CORRECTABLE_ERROR_REPORTING 0x00000001
7417 #define ROOT_CMD_ENABLE_NONFATAL_ERROR_REPORTING 0x00000002
7418 #define ROOT_CMD_ENABLE_FATAL_ERROR_REPORTING 0x00000004
7420 #define ROOT_CMD_ERROR_REPORTING_ENABLE_MASK \
7421 (ROOT_CMD_ENABLE_FATAL_ERROR_REPORTING | \
7422 ROOT_CMD_ENABLE_NONFATAL_ERROR_REPORTING | \
7423 ROOT_CMD_ENABLE_CORRECTABLE_ERROR_REPORTING)
7425 typedef struct _PCI_EXPRESS_AER_CAPABILITY
{
7426 PCI_EXPRESS_ENHANCED_CAPABILITY_HEADER Header
;
7427 PCI_EXPRESS_UNCORRECTABLE_ERROR_STATUS UncorrectableErrorStatus
;
7428 PCI_EXPRESS_UNCORRECTABLE_ERROR_MASK UncorrectableErrorMask
;
7429 PCI_EXPRESS_UNCORRECTABLE_ERROR_SEVERITY UncorrectableErrorSeverity
;
7430 PCI_EXPRESS_CORRECTABLE_ERROR_STATUS CorrectableErrorStatus
;
7431 PCI_EXPRESS_CORRECTABLE_ERROR_MASK CorrectableErrorMask
;
7432 PCI_EXPRESS_AER_CAPABILITIES CapabilitiesAndControl
;
7434 PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_STATUS SecUncorrectableErrorStatus
;
7435 PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_MASK SecUncorrectableErrorMask
;
7436 PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_SEVERITY SecUncorrectableErrorSeverity
;
7437 PCI_EXPRESS_SEC_AER_CAPABILITIES SecCapabilitiesAndControl
;
7438 ULONG SecHeaderLog
[4];
7439 } PCI_EXPRESS_AER_CAPABILITY
, *PPCI_EXPRESS_AER_CAPABILITY
;
7441 typedef struct _PCI_EXPRESS_ROOTPORT_AER_CAPABILITY
{
7442 PCI_EXPRESS_ENHANCED_CAPABILITY_HEADER Header
;
7443 PCI_EXPRESS_UNCORRECTABLE_ERROR_STATUS UncorrectableErrorStatus
;
7444 PCI_EXPRESS_UNCORRECTABLE_ERROR_MASK UncorrectableErrorMask
;
7445 PCI_EXPRESS_UNCORRECTABLE_ERROR_SEVERITY UncorrectableErrorSeverity
;
7446 PCI_EXPRESS_CORRECTABLE_ERROR_STATUS CorrectableErrorStatus
;
7447 PCI_EXPRESS_CORRECTABLE_ERROR_MASK CorrectableErrorMask
;
7448 PCI_EXPRESS_AER_CAPABILITIES CapabilitiesAndControl
;
7450 PCI_EXPRESS_ROOT_ERROR_COMMAND RootErrorCommand
;
7451 PCI_EXPRESS_ROOT_ERROR_STATUS RootErrorStatus
;
7452 PCI_EXPRESS_ERROR_SOURCE_ID ErrorSourceId
;
7453 } PCI_EXPRESS_ROOTPORT_AER_CAPABILITY
, *PPCI_EXPRESS_ROOTPORT_AER_CAPABILITY
;
7455 typedef struct _PCI_EXPRESS_BRIDGE_AER_CAPABILITY
{
7456 PCI_EXPRESS_ENHANCED_CAPABILITY_HEADER Header
;
7457 PCI_EXPRESS_UNCORRECTABLE_ERROR_STATUS UncorrectableErrorStatus
;
7458 PCI_EXPRESS_UNCORRECTABLE_ERROR_MASK UncorrectableErrorMask
;
7459 PCI_EXPRESS_UNCORRECTABLE_ERROR_SEVERITY UncorrectableErrorSeverity
;
7460 PCI_EXPRESS_CORRECTABLE_ERROR_STATUS CorrectableErrorStatus
;
7461 PCI_EXPRESS_CORRECTABLE_ERROR_MASK CorrectableErrorMask
;
7462 PCI_EXPRESS_AER_CAPABILITIES CapabilitiesAndControl
;
7464 PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_STATUS SecUncorrectableErrorStatus
;
7465 PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_MASK SecUncorrectableErrorMask
;
7466 PCI_EXPRESS_SEC_UNCORRECTABLE_ERROR_SEVERITY SecUncorrectableErrorSeverity
;
7467 PCI_EXPRESS_SEC_AER_CAPABILITIES SecCapabilitiesAndControl
;
7468 ULONG SecHeaderLog
[4];
7469 } PCI_EXPRESS_BRIDGE_AER_CAPABILITY
, *PPCI_EXPRESS_BRIDGE_AER_CAPABILITY
;
7471 typedef union _PCI_EXPRESS_SRIOV_CAPS
{
7472 _ANONYMOUS_STRUCT
struct {
7473 ULONG VFMigrationCapable
:1;
7475 ULONG VFMigrationInterruptNumber
:11;
7478 } PCI_EXPRESS_SRIOV_CAPS
, *PPCI_EXPRESS_SRIOV_CAPS
;
7480 typedef union _PCI_EXPRESS_SRIOV_CONTROL
{
7481 _ANONYMOUS_STRUCT
struct {
7483 USHORT VFMigrationEnable
:1;
7484 USHORT VFMigrationInterruptEnable
:1;
7485 USHORT VFMemorySpaceEnable
:1;
7486 USHORT ARICapableHierarchy
:1;
7487 USHORT Reserved1
:11;
7490 } PCI_EXPRESS_SRIOV_CONTROL
, *PPCI_EXPRESS_SRIOV_CONTROL
;
7492 typedef union _PCI_EXPRESS_SRIOV_STATUS
{
7493 _ANONYMOUS_STRUCT
struct {
7494 USHORT VFMigrationStatus
:1;
7495 USHORT Reserved1
:15;
7498 } PCI_EXPRESS_SRIOV_STATUS
, *PPCI_EXPRESS_SRIOV_STATUS
;
7500 typedef union _PCI_EXPRESS_SRIOV_MIGRATION_STATE_ARRAY
{
7501 _ANONYMOUS_STRUCT
struct {
7502 ULONG VFMigrationStateBIR
:3;
7503 ULONG VFMigrationStateOffset
:29;
7506 } PCI_EXPRESS_SRIOV_MIGRATION_STATE_ARRAY
, *PPCI_EXPRESS_SRIOV_MIGRATION_STATE_ARRAY
;
7508 typedef struct _PCI_EXPRESS_SRIOV_CAPABILITY
{
7509 PCI_EXPRESS_ENHANCED_CAPABILITY_HEADER Header
;
7510 PCI_EXPRESS_SRIOV_CAPS SRIOVCapabilities
;
7511 PCI_EXPRESS_SRIOV_CONTROL SRIOVControl
;
7512 PCI_EXPRESS_SRIOV_STATUS SRIOVStatus
;
7516 UCHAR FunctionDependencyLink
;
7518 USHORT FirstVFOffset
;
7522 ULONG SupportedPageSizes
;
7523 ULONG SystemPageSize
;
7524 ULONG BaseAddresses
[PCI_TYPE0_ADDRESSES
];
7525 PCI_EXPRESS_SRIOV_MIGRATION_STATE_ARRAY VFMigrationStateArrayOffset
;
7526 } PCI_EXPRESS_SRIOV_CAPABILITY
, *PPCI_EXPRESS_SRIOV_CAPABILITY
;
7528 /* PCI device classes */
7529 #define PCI_CLASS_PRE_20 0x00
7530 #define PCI_CLASS_MASS_STORAGE_CTLR 0x01
7531 #define PCI_CLASS_NETWORK_CTLR 0x02
7532 #define PCI_CLASS_DISPLAY_CTLR 0x03
7533 #define PCI_CLASS_MULTIMEDIA_DEV 0x04
7534 #define PCI_CLASS_MEMORY_CTLR 0x05
7535 #define PCI_CLASS_BRIDGE_DEV 0x06
7536 #define PCI_CLASS_SIMPLE_COMMS_CTLR 0x07
7537 #define PCI_CLASS_BASE_SYSTEM_DEV 0x08
7538 #define PCI_CLASS_INPUT_DEV 0x09
7539 #define PCI_CLASS_DOCKING_STATION 0x0a
7540 #define PCI_CLASS_PROCESSOR 0x0b
7541 #define PCI_CLASS_SERIAL_BUS_CTLR 0x0c
7542 #define PCI_CLASS_WIRELESS_CTLR 0x0d
7543 #define PCI_CLASS_INTELLIGENT_IO_CTLR 0x0e
7544 #define PCI_CLASS_SATELLITE_COMMS_CTLR 0x0f
7545 #define PCI_CLASS_ENCRYPTION_DECRYPTION 0x10
7546 #define PCI_CLASS_DATA_ACQ_SIGNAL_PROC 0x11
7547 #define PCI_CLASS_NOT_DEFINED 0xff
7549 /* PCI device subclasses for class 0 */
7550 #define PCI_SUBCLASS_PRE_20_NON_VGA 0x00
7551 #define PCI_SUBCLASS_PRE_20_VGA 0x01
7553 /* PCI device subclasses for class 1 (mass storage controllers)*/
7554 #define PCI_SUBCLASS_MSC_SCSI_BUS_CTLR 0x00
7555 #define PCI_SUBCLASS_MSC_IDE_CTLR 0x01
7556 #define PCI_SUBCLASS_MSC_FLOPPY_CTLR 0x02
7557 #define PCI_SUBCLASS_MSC_IPI_CTLR 0x03
7558 #define PCI_SUBCLASS_MSC_RAID_CTLR 0x04
7559 #define PCI_SUBCLASS_MSC_OTHER 0x80
7561 /* PCI device subclasses for class 2 (network controllers)*/
7562 #define PCI_SUBCLASS_NET_ETHERNET_CTLR 0x00
7563 #define PCI_SUBCLASS_NET_TOKEN_RING_CTLR 0x01
7564 #define PCI_SUBCLASS_NET_FDDI_CTLR 0x02
7565 #define PCI_SUBCLASS_NET_ATM_CTLR 0x03
7566 #define PCI_SUBCLASS_NET_ISDN_CTLR 0x04
7567 #define PCI_SUBCLASS_NET_OTHER 0x80
7569 /* PCI device subclasses for class 3 (display controllers)*/
7570 #define PCI_SUBCLASS_VID_VGA_CTLR 0x00
7571 #define PCI_SUBCLASS_VID_XGA_CTLR 0x01
7572 #define PCI_SUBCLASS_VID_3D_CTLR 0x02
7573 #define PCI_SUBCLASS_VID_OTHER 0x80
7575 /* PCI device subclasses for class 4 (multimedia device)*/
7576 #define PCI_SUBCLASS_MM_VIDEO_DEV 0x00
7577 #define PCI_SUBCLASS_MM_AUDIO_DEV 0x01
7578 #define PCI_SUBCLASS_MM_TELEPHONY_DEV 0x02
7579 #define PCI_SUBCLASS_MM_OTHER 0x80
7581 /* PCI device subclasses for class 5 (memory controller)*/
7582 #define PCI_SUBCLASS_MEM_RAM 0x00
7583 #define PCI_SUBCLASS_MEM_FLASH 0x01
7584 #define PCI_SUBCLASS_MEM_OTHER 0x80
7586 /* PCI device subclasses for class 6 (bridge device)*/
7587 #define PCI_SUBCLASS_BR_HOST 0x00
7588 #define PCI_SUBCLASS_BR_ISA 0x01
7589 #define PCI_SUBCLASS_BR_EISA 0x02
7590 #define PCI_SUBCLASS_BR_MCA 0x03
7591 #define PCI_SUBCLASS_BR_PCI_TO_PCI 0x04
7592 #define PCI_SUBCLASS_BR_PCMCIA 0x05
7593 #define PCI_SUBCLASS_BR_NUBUS 0x06
7594 #define PCI_SUBCLASS_BR_CARDBUS 0x07
7595 #define PCI_SUBCLASS_BR_RACEWAY 0x08
7596 #define PCI_SUBCLASS_BR_OTHER 0x80
7598 #define PCI_SUBCLASS_COM_SERIAL 0x00
7599 #define PCI_SUBCLASS_COM_PARALLEL 0x01
7600 #define PCI_SUBCLASS_COM_MULTIPORT 0x02
7601 #define PCI_SUBCLASS_COM_MODEM 0x03
7602 #define PCI_SUBCLASS_COM_OTHER 0x80
7604 #define PCI_SUBCLASS_SYS_INTERRUPT_CTLR 0x00
7605 #define PCI_SUBCLASS_SYS_DMA_CTLR 0x01
7606 #define PCI_SUBCLASS_SYS_SYSTEM_TIMER 0x02
7607 #define PCI_SUBCLASS_SYS_REAL_TIME_CLOCK 0x03
7608 #define PCI_SUBCLASS_SYS_GEN_HOTPLUG_CTLR 0x04
7609 #define PCI_SUBCLASS_SYS_SDIO_CTRL 0x05
7610 #define PCI_SUBCLASS_SYS_OTHER 0x80
7612 #define PCI_SUBCLASS_INP_KEYBOARD 0x00
7613 #define PCI_SUBCLASS_INP_DIGITIZER 0x01
7614 #define PCI_SUBCLASS_INP_MOUSE 0x02
7615 #define PCI_SUBCLASS_INP_SCANNER 0x03
7616 #define PCI_SUBCLASS_INP_GAMEPORT 0x04
7617 #define PCI_SUBCLASS_INP_OTHER 0x80
7619 #define PCI_SUBCLASS_DOC_GENERIC 0x00
7620 #define PCI_SUBCLASS_DOC_OTHER 0x80
7622 #define PCI_SUBCLASS_PROC_386 0x00
7623 #define PCI_SUBCLASS_PROC_486 0x01
7624 #define PCI_SUBCLASS_PROC_PENTIUM 0x02
7625 #define PCI_SUBCLASS_PROC_ALPHA 0x10
7626 #define PCI_SUBCLASS_PROC_POWERPC 0x20
7627 #define PCI_SUBCLASS_PROC_COPROCESSOR 0x40
7629 /* PCI device subclasses for class C (serial bus controller)*/
7630 #define PCI_SUBCLASS_SB_IEEE1394 0x00
7631 #define PCI_SUBCLASS_SB_ACCESS 0x01
7632 #define PCI_SUBCLASS_SB_SSA 0x02
7633 #define PCI_SUBCLASS_SB_USB 0x03
7634 #define PCI_SUBCLASS_SB_FIBRE_CHANNEL 0x04
7635 #define PCI_SUBCLASS_SB_SMBUS 0x05
7637 #define PCI_SUBCLASS_WIRELESS_IRDA 0x00
7638 #define PCI_SUBCLASS_WIRELESS_CON_IR 0x01
7639 #define PCI_SUBCLASS_WIRELESS_RF 0x10
7640 #define PCI_SUBCLASS_WIRELESS_OTHER 0x80
7642 #define PCI_SUBCLASS_INTIO_I2O 0x00
7644 #define PCI_SUBCLASS_SAT_TV 0x01
7645 #define PCI_SUBCLASS_SAT_AUDIO 0x02
7646 #define PCI_SUBCLASS_SAT_VOICE 0x03
7647 #define PCI_SUBCLASS_SAT_DATA 0x04
7649 #define PCI_SUBCLASS_CRYPTO_NET_COMP 0x00
7650 #define PCI_SUBCLASS_CRYPTO_ENTERTAINMENT 0x10
7651 #define PCI_SUBCLASS_CRYPTO_OTHER 0x80
7653 #define PCI_SUBCLASS_DASP_DPIO 0x00
7654 #define PCI_SUBCLASS_DASP_OTHER 0x80
7656 #define PCI_ADDRESS_IO_SPACE 0x00000001
7657 #define PCI_ADDRESS_MEMORY_TYPE_MASK 0x00000006
7658 #define PCI_ADDRESS_MEMORY_PREFETCHABLE 0x00000008
7659 #define PCI_ADDRESS_IO_ADDRESS_MASK 0xfffffffc
7660 #define PCI_ADDRESS_MEMORY_ADDRESS_MASK 0xfffffff0
7661 #define PCI_ADDRESS_ROM_ADDRESS_MASK 0xfffff800
7663 #define PCI_TYPE_32BIT 0
7664 #define PCI_TYPE_20BIT 2
7665 #define PCI_TYPE_64BIT 4
7667 #define PCI_ROMADDRESS_ENABLED 0x00000001
7669 #endif /* _PCI_X_ */
7671 #define PCI_EXPRESS_LINK_QUIESCENT_INTERFACE_VERSION 1
7673 _IRQL_requires_max_(PASSIVE_LEVEL
)
7674 _Must_inspect_result_
7676 (NTAPI PCI_EXPRESS_ENTER_LINK_QUIESCENT_MODE
)(
7677 _Inout_ PVOID Context
);
7678 typedef PCI_EXPRESS_ENTER_LINK_QUIESCENT_MODE
*PPCI_EXPRESS_ENTER_LINK_QUIESCENT_MODE
;
7680 _IRQL_requires_max_(PASSIVE_LEVEL
)
7681 _Must_inspect_result_
7683 (NTAPI PCI_EXPRESS_EXIT_LINK_QUIESCENT_MODE
)(
7684 _Inout_ PVOID Context
);
7685 typedef PCI_EXPRESS_EXIT_LINK_QUIESCENT_MODE
*PPCI_EXPRESS_EXIT_LINK_QUIESCENT_MODE
;
7687 typedef struct _PCI_EXPRESS_LINK_QUIESCENT_INTERFACE
{
7691 PINTERFACE_REFERENCE InterfaceReference
;
7692 PINTERFACE_DEREFERENCE InterfaceDereference
;
7693 PPCI_EXPRESS_ENTER_LINK_QUIESCENT_MODE PciExpressEnterLinkQuiescentMode
;
7694 PPCI_EXPRESS_EXIT_LINK_QUIESCENT_MODE PciExpressExitLinkQuiescentMode
;
7695 } PCI_EXPRESS_LINK_QUIESCENT_INTERFACE
, *PPCI_EXPRESS_LINK_QUIESCENT_INTERFACE
;
7697 #define PCI_EXPRESS_ROOT_PORT_INTERFACE_VERSION 1
7700 (NTAPI
*PPCI_EXPRESS_ROOT_PORT_READ_CONFIG_SPACE
)(
7702 _Out_writes_bytes_(Length
) PVOID Buffer
,
7707 (NTAPI
*PPCI_EXPRESS_ROOT_PORT_WRITE_CONFIG_SPACE
)(
7709 _In_reads_bytes_(Length
) PVOID Buffer
,
7713 typedef struct _PCI_EXPRESS_ROOT_PORT_INTERFACE
{
7717 PINTERFACE_REFERENCE InterfaceReference
;
7718 PINTERFACE_DEREFERENCE InterfaceDereference
;
7719 PPCI_EXPRESS_ROOT_PORT_READ_CONFIG_SPACE ReadConfigSpace
;
7720 PPCI_EXPRESS_ROOT_PORT_WRITE_CONFIG_SPACE WriteConfigSpace
;
7721 } PCI_EXPRESS_ROOT_PORT_INTERFACE
, *PPCI_EXPRESS_ROOT_PORT_INTERFACE
;
7723 #define PCI_MSIX_TABLE_CONFIG_INTERFACE_VERSION 1
7725 _Must_inspect_result_
7727 (NTAPI PCI_MSIX_SET_ENTRY
)(
7729 _In_ ULONG TableEntry
,
7730 _In_ ULONG MessageNumber
);
7731 typedef PCI_MSIX_SET_ENTRY
*PPCI_MSIX_SET_ENTRY
;
7733 _Must_inspect_result_
7735 (NTAPI PCI_MSIX_MASKUNMASK_ENTRY
)(
7737 _In_ ULONG TableEntry
);
7738 typedef PCI_MSIX_MASKUNMASK_ENTRY
*PPCI_MSIX_MASKUNMASK_ENTRY
;
7740 _Must_inspect_result_
7742 (NTAPI PCI_MSIX_GET_ENTRY
)(
7744 _In_ ULONG TableEntry
,
7745 _Out_ PULONG MessageNumber
,
7746 _Out_ PBOOLEAN Masked
);
7747 typedef PCI_MSIX_GET_ENTRY
*PPCI_MSIX_GET_ENTRY
;
7749 _Must_inspect_result_
7751 (NTAPI PCI_MSIX_GET_TABLE_SIZE
)(
7753 _Out_ PULONG TableSize
);
7754 typedef PCI_MSIX_GET_TABLE_SIZE
*PPCI_MSIX_GET_TABLE_SIZE
;
7756 typedef struct _PCI_MSIX_TABLE_CONFIG_INTERFACE
{
7760 PINTERFACE_REFERENCE InterfaceReference
;
7761 PINTERFACE_DEREFERENCE InterfaceDereference
;
7762 PPCI_MSIX_SET_ENTRY SetTableEntry
;
7763 PPCI_MSIX_MASKUNMASK_ENTRY MaskTableEntry
;
7764 PPCI_MSIX_MASKUNMASK_ENTRY UnmaskTableEntry
;
7765 PPCI_MSIX_GET_ENTRY GetTableEntry
;
7766 PPCI_MSIX_GET_TABLE_SIZE GetTableSize
;
7767 } PCI_MSIX_TABLE_CONFIG_INTERFACE
, *PPCI_MSIX_TABLE_CONFIG_INTERFACE
;
7769 #define PCI_MSIX_TABLE_CONFIG_MINIMUM_SIZE \
7770 RTL_SIZEOF_THROUGH_FIELD(PCI_MSIX_TABLE_CONFIG_INTERFACE, UnmaskTableEntry)
7772 /******************************************************************************
7773 * Object Manager Types *
7774 ******************************************************************************/
7776 #define MAXIMUM_FILENAME_LENGTH 256
7777 #define OBJ_NAME_PATH_SEPARATOR ((WCHAR)L'\\')
7779 #define OBJECT_TYPE_CREATE 0x0001
7780 #define OBJECT_TYPE_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | 0x1)
7782 #define DIRECTORY_QUERY 0x0001
7783 #define DIRECTORY_TRAVERSE 0x0002
7784 #define DIRECTORY_CREATE_OBJECT 0x0004
7785 #define DIRECTORY_CREATE_SUBDIRECTORY 0x0008
7786 #define DIRECTORY_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | 0xF)
7788 #define SYMBOLIC_LINK_QUERY 0x0001
7789 #define SYMBOLIC_LINK_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | 0x1)
7791 #define DUPLICATE_CLOSE_SOURCE 0x00000001
7792 #define DUPLICATE_SAME_ACCESS 0x00000002
7793 #define DUPLICATE_SAME_ATTRIBUTES 0x00000004
7795 #define OB_FLT_REGISTRATION_VERSION_0100 0x0100
7796 #define OB_FLT_REGISTRATION_VERSION OB_FLT_REGISTRATION_VERSION_0100
7798 typedef ULONG OB_OPERATION
;
7800 #define OB_OPERATION_HANDLE_CREATE 0x00000001
7801 #define OB_OPERATION_HANDLE_DUPLICATE 0x00000002
7803 typedef struct _OB_PRE_CREATE_HANDLE_INFORMATION
{
7804 _Inout_ ACCESS_MASK DesiredAccess
;
7805 _In_ ACCESS_MASK OriginalDesiredAccess
;
7806 } OB_PRE_CREATE_HANDLE_INFORMATION
, *POB_PRE_CREATE_HANDLE_INFORMATION
;
7808 typedef struct _OB_PRE_DUPLICATE_HANDLE_INFORMATION
{
7809 _Inout_ ACCESS_MASK DesiredAccess
;
7810 _In_ ACCESS_MASK OriginalDesiredAccess
;
7811 _In_ PVOID SourceProcess
;
7812 _In_ PVOID TargetProcess
;
7813 } OB_PRE_DUPLICATE_HANDLE_INFORMATION
, *POB_PRE_DUPLICATE_HANDLE_INFORMATION
;
7815 typedef union _OB_PRE_OPERATION_PARAMETERS
{
7816 _Inout_ OB_PRE_CREATE_HANDLE_INFORMATION CreateHandleInformation
;
7817 _Inout_ OB_PRE_DUPLICATE_HANDLE_INFORMATION DuplicateHandleInformation
;
7818 } OB_PRE_OPERATION_PARAMETERS
, *POB_PRE_OPERATION_PARAMETERS
;
7820 typedef struct _OB_PRE_OPERATION_INFORMATION
{
7821 _In_ OB_OPERATION Operation
;
7822 _ANONYMOUS_UNION
union {
7824 _ANONYMOUS_STRUCT
struct {
7825 _In_ ULONG KernelHandle
:1;
7826 _In_ ULONG Reserved
:31;
7830 _In_ POBJECT_TYPE ObjectType
;
7831 _Out_ PVOID CallContext
;
7832 _In_ POB_PRE_OPERATION_PARAMETERS Parameters
;
7833 } OB_PRE_OPERATION_INFORMATION
, *POB_PRE_OPERATION_INFORMATION
;
7835 typedef struct _OB_POST_CREATE_HANDLE_INFORMATION
{
7836 _In_ ACCESS_MASK GrantedAccess
;
7837 } OB_POST_CREATE_HANDLE_INFORMATION
, *POB_POST_CREATE_HANDLE_INFORMATION
;
7839 typedef struct _OB_POST_DUPLICATE_HANDLE_INFORMATION
{
7840 _In_ ACCESS_MASK GrantedAccess
;
7841 } OB_POST_DUPLICATE_HANDLE_INFORMATION
, *POB_POST_DUPLICATE_HANDLE_INFORMATION
;
7843 typedef union _OB_POST_OPERATION_PARAMETERS
{
7844 _In_ OB_POST_CREATE_HANDLE_INFORMATION CreateHandleInformation
;
7845 _In_ OB_POST_DUPLICATE_HANDLE_INFORMATION DuplicateHandleInformation
;
7846 } OB_POST_OPERATION_PARAMETERS
, *POB_POST_OPERATION_PARAMETERS
;
7848 typedef struct _OB_POST_OPERATION_INFORMATION
{
7849 _In_ OB_OPERATION Operation
;
7850 _ANONYMOUS_UNION
union {
7852 _ANONYMOUS_STRUCT
struct {
7853 _In_ ULONG KernelHandle
:1;
7854 _In_ ULONG Reserved
:31;
7858 _In_ POBJECT_TYPE ObjectType
;
7859 _In_ PVOID CallContext
;
7860 _In_ NTSTATUS ReturnStatus
;
7861 _In_ POB_POST_OPERATION_PARAMETERS Parameters
;
7862 } OB_POST_OPERATION_INFORMATION
,*POB_POST_OPERATION_INFORMATION
;
7864 typedef enum _OB_PREOP_CALLBACK_STATUS
{
7866 } OB_PREOP_CALLBACK_STATUS
, *POB_PREOP_CALLBACK_STATUS
;
7868 typedef OB_PREOP_CALLBACK_STATUS
7869 (NTAPI
*POB_PRE_OPERATION_CALLBACK
)(
7870 _In_ PVOID RegistrationContext
,
7871 _Inout_ POB_PRE_OPERATION_INFORMATION OperationInformation
);
7874 (NTAPI
*POB_POST_OPERATION_CALLBACK
)(
7875 _In_ PVOID RegistrationContext
,
7876 _In_ POB_POST_OPERATION_INFORMATION OperationInformation
);
7878 typedef struct _OB_OPERATION_REGISTRATION
{
7879 _In_ POBJECT_TYPE
*ObjectType
;
7880 _In_ OB_OPERATION Operations
;
7881 _In_ POB_PRE_OPERATION_CALLBACK PreOperation
;
7882 _In_ POB_POST_OPERATION_CALLBACK PostOperation
;
7883 } OB_OPERATION_REGISTRATION
, *POB_OPERATION_REGISTRATION
;
7885 typedef struct _OB_CALLBACK_REGISTRATION
{
7886 _In_ USHORT Version
;
7887 _In_ USHORT OperationRegistrationCount
;
7888 _In_ UNICODE_STRING Altitude
;
7889 _In_ PVOID RegistrationContext
;
7890 _In_ OB_OPERATION_REGISTRATION
*OperationRegistration
;
7891 } OB_CALLBACK_REGISTRATION
, *POB_CALLBACK_REGISTRATION
;
7893 typedef struct _OBJECT_NAME_INFORMATION
{
7894 UNICODE_STRING Name
;
7895 } OBJECT_NAME_INFORMATION
, *POBJECT_NAME_INFORMATION
;
7897 /* Exported object types */
7899 extern POBJECT_TYPE NTSYSAPI CmKeyObjectType
;
7900 extern POBJECT_TYPE NTSYSAPI ExEventObjectType
;
7901 extern POBJECT_TYPE NTSYSAPI ExSemaphoreObjectType
;
7902 extern POBJECT_TYPE NTSYSAPI IoFileObjectType
;
7903 extern POBJECT_TYPE NTSYSAPI PsThreadType
;
7904 extern POBJECT_TYPE NTSYSAPI SeTokenObjectType
;
7905 extern POBJECT_TYPE NTSYSAPI PsProcessType
;
7907 extern POBJECT_TYPE
*CmKeyObjectType
;
7908 extern POBJECT_TYPE
*IoFileObjectType
;
7909 extern POBJECT_TYPE
*ExEventObjectType
;
7910 extern POBJECT_TYPE
*ExSemaphoreObjectType
;
7911 extern POBJECT_TYPE
*TmTransactionManagerObjectType
;
7912 extern POBJECT_TYPE
*TmResourceManagerObjectType
;
7913 extern POBJECT_TYPE
*TmEnlistmentObjectType
;
7914 extern POBJECT_TYPE
*TmTransactionObjectType
;
7915 extern POBJECT_TYPE
*PsProcessType
;
7916 extern POBJECT_TYPE
*PsThreadType
;
7917 extern POBJECT_TYPE
*SeTokenObjectType
;
7918 __CREATE_NTOS_DATA_IMPORT_ALIAS(CmKeyObjectType
)
7919 __CREATE_NTOS_DATA_IMPORT_ALIAS(IoFileObjectType
)
7920 __CREATE_NTOS_DATA_IMPORT_ALIAS(ExEventObjectType
)
7921 __CREATE_NTOS_DATA_IMPORT_ALIAS(ExSemaphoreObjectType
)
7922 __CREATE_NTOS_DATA_IMPORT_ALIAS(TmTransactionManagerObjectType
)
7923 __CREATE_NTOS_DATA_IMPORT_ALIAS(TmResourceManagerObjectType
)
7924 __CREATE_NTOS_DATA_IMPORT_ALIAS(TmEnlistmentObjectType
)
7925 __CREATE_NTOS_DATA_IMPORT_ALIAS(TmTransactionObjectType
)
7926 __CREATE_NTOS_DATA_IMPORT_ALIAS(PsProcessType
)
7927 __CREATE_NTOS_DATA_IMPORT_ALIAS(PsThreadType
)
7928 __CREATE_NTOS_DATA_IMPORT_ALIAS(SeTokenObjectType
)
7932 /******************************************************************************
7933 * Process Manager Types *
7934 ******************************************************************************/
7936 #define QUOTA_LIMITS_HARDWS_MIN_ENABLE 0x00000001
7937 #define QUOTA_LIMITS_HARDWS_MIN_DISABLE 0x00000002
7938 #define QUOTA_LIMITS_HARDWS_MAX_ENABLE 0x00000004
7939 #define QUOTA_LIMITS_HARDWS_MAX_DISABLE 0x00000008
7940 #define QUOTA_LIMITS_USE_DEFAULT_LIMITS 0x00000010
7942 /* Thread Access Rights */
7943 #define THREAD_TERMINATE 0x0001
7944 #define THREAD_SUSPEND_RESUME 0x0002
7945 #define THREAD_ALERT 0x0004
7946 #define THREAD_GET_CONTEXT 0x0008
7947 #define THREAD_SET_CONTEXT 0x0010
7948 #define THREAD_SET_INFORMATION 0x0020
7949 #define THREAD_SET_LIMITED_INFORMATION 0x0400
7950 #define THREAD_QUERY_LIMITED_INFORMATION 0x0800
7952 #define PROCESS_DUP_HANDLE (0x0040)
7954 #if (NTDDI_VERSION >= NTDDI_VISTA)
7955 #define PROCESS_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0xFFFF)
7957 #define PROCESS_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0xFFF)
7960 #if (NTDDI_VERSION >= NTDDI_VISTA)
7961 #define THREAD_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0xFFFF)
7963 #define THREAD_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0x3FF)
7966 #define LOW_PRIORITY 0
7967 #define LOW_REALTIME_PRIORITY 16
7968 #define HIGH_PRIORITY 31
7969 #define MAXIMUM_PRIORITY 32
7972 /******************************************************************************
7973 * WMI Library Support Types *
7974 ******************************************************************************/
7977 #include <evntrace.h>
7981 #ifndef _TRACEHANDLE_DEFINED
7982 #define _TRACEHANDLE_DEFINED
7983 typedef ULONG64 TRACEHANDLE
, *PTRACEHANDLE
;
7986 #ifndef TRACE_INFORMATION_CLASS_DEFINE
7988 typedef struct _ETW_TRACE_SESSION_SETTINGS
{
7991 ULONG MinimumBuffers
;
7992 ULONG MaximumBuffers
;
7995 ULONG FlushThreshold
;
7997 } ETW_TRACE_SESSION_SETTINGS
, *PETW_TRACE_SESSION_SETTINGS
;
7999 typedef enum _TRACE_INFORMATION_CLASS
{
8002 TraceEnableFlagsClass
,
8003 TraceEnableLevelClass
,
8004 GlobalLoggerHandleClass
,
8005 EventLoggerHandleClass
,
8006 AllLoggerHandlesClass
,
8007 TraceHandleByNameClass
,
8008 LoggerEventsLostClass
,
8009 TraceSessionSettingsClass
,
8010 LoggerEventsLoggedClass
,
8011 MaxTraceInformationClass
8012 } TRACE_INFORMATION_CLASS
;
8014 #endif /* TRACE_INFORMATION_CLASS_DEFINE */
8020 #include <evntprov.h>
8022 _IRQL_requires_same_
8024 (NTAPI
*PETWENABLECALLBACK
)(
8025 _In_ LPCGUID SourceId
,
8026 _In_ ULONG ControlCode
,
8028 _In_ ULONGLONG MatchAnyKeyword
,
8029 _In_ ULONGLONG MatchAllKeyword
,
8030 _In_opt_ PEVENT_FILTER_DESCRIPTOR FilterData
,
8031 _Inout_opt_ PVOID CallbackContext
);
8033 #define EVENT_WRITE_FLAG_NO_FAULTING 0x00000001
8036 /******************************************************************************
8037 * Kernel Functions *
8038 ******************************************************************************/
8039 #if defined(_M_IX86)
8040 /** Kernel definitions for x86 **/
8042 /* Interrupt request levels */
8043 #define PASSIVE_LEVEL 0
8046 #define DISPATCH_LEVEL 2
8047 #define CMCI_LEVEL 5
8048 #define PROFILE_LEVEL 27
8049 #define CLOCK1_LEVEL 28
8050 #define CLOCK2_LEVEL 28
8051 #define IPI_LEVEL 29
8052 #define POWER_LEVEL 30
8053 #define HIGH_LEVEL 31
8054 #define CLOCK_LEVEL CLOCK2_LEVEL
8056 #define KIP0PCRADDRESS 0xffdff000
8057 #define KI_USER_SHARED_DATA 0xffdf0000
8058 #define SharedUserData ((KUSER_SHARED_DATA * CONST)KI_USER_SHARED_DATA)
8060 #define PAGE_SIZE 0x1000
8061 #define PAGE_SHIFT 12L
8062 #define KeGetDcacheFillSize() 1L
8064 #define EFLAG_SIGN 0x8000
8065 #define EFLAG_ZERO 0x4000
8066 #define EFLAG_SELECT (EFLAG_SIGN | EFLAG_ZERO)
8068 #define RESULT_NEGATIVE ((EFLAG_SIGN & ~EFLAG_ZERO) & EFLAG_SELECT)
8069 #define RESULT_ZERO ((~EFLAG_SIGN & EFLAG_ZERO) & EFLAG_SELECT)
8070 #define RESULT_POSITIVE ((~EFLAG_SIGN & ~EFLAG_ZERO) & EFLAG_SELECT)
8073 typedef struct _KFLOATING_SAVE
{
8077 ULONG ErrorSelector
;
8082 } KFLOATING_SAVE
, *PKFLOATING_SAVE
;
8084 extern NTKERNELAPI
volatile KSYSTEM_TIME KeTickCount
;
8086 #define YieldProcessor _mm_pause
8090 KeMemoryBarrier(VOID
)
8092 LONG Barrier
, *Dummy
= &Barrier
;
8093 UNREFERENCED_LOCAL_VARIABLE(Dummy
);
8095 #if defined(__GNUC__)
8096 __asm__
__volatile__ ("xchg %%eax, %0" : : "m" (Barrier
) : "%eax");
8097 #elif defined(_MSC_VER)
8098 __asm xchg
[Barrier
], eax
8102 #define KeMemoryBarrierWithoutFence() _ReadWriteBarrier()
8104 _IRQL_requires_max_(HIGH_LEVEL
)
8109 KeGetCurrentIrql(VOID
);
8111 _IRQL_requires_max_(HIGH_LEVEL
)
8116 _In_ _IRQL_restores_ _Notliteral_ KIRQL NewIrql
);
8117 #define KeLowerIrql(a) KfLowerIrql(a)
8119 _IRQL_requires_max_(HIGH_LEVEL
)
8120 _IRQL_raises_(NewIrql
)
8126 _In_ KIRQL NewIrql
);
8127 #define KeRaiseIrql(a,b) *(b) = KfRaiseIrql(a)
8129 _IRQL_requires_max_(DISPATCH_LEVEL
)
8131 _IRQL_raises_(DISPATCH_LEVEL
)
8135 KeRaiseIrqlToDpcLevel(VOID
);
8140 KeRaiseIrqlToSynchLevel(VOID
);
8142 _Requires_lock_not_held_(*SpinLock
)
8143 _Acquires_lock_(*SpinLock
)
8144 _IRQL_requires_max_(DISPATCH_LEVEL
)
8146 _IRQL_raises_(DISPATCH_LEVEL
)
8151 _Inout_ PKSPIN_LOCK SpinLock
);
8152 #define KeAcquireSpinLock(a,b) *(b) = KfAcquireSpinLock(a)
8154 _Requires_lock_held_(*SpinLock
)
8155 _Releases_lock_(*SpinLock
)
8156 _IRQL_requires_(DISPATCH_LEVEL
)
8161 _Inout_ PKSPIN_LOCK SpinLock
,
8162 _In_ _IRQL_restores_ KIRQL NewIrql
);
8163 #define KeReleaseSpinLock(a,b) KfReleaseSpinLock(a,b)
8165 _Requires_lock_not_held_(*SpinLock
)
8166 _Acquires_lock_(*SpinLock
)
8167 _IRQL_requires_min_(DISPATCH_LEVEL
)
8171 KefAcquireSpinLockAtDpcLevel(
8172 _Inout_ PKSPIN_LOCK SpinLock
);
8173 #define KeAcquireSpinLockAtDpcLevel(SpinLock) KefAcquireSpinLockAtDpcLevel(SpinLock)
8175 _Requires_lock_held_(*SpinLock
)
8176 _Releases_lock_(*SpinLock
)
8177 _IRQL_requires_min_(DISPATCH_LEVEL
)
8181 KefReleaseSpinLockFromDpcLevel(
8182 _Inout_ PKSPIN_LOCK SpinLock
);
8183 #define KeReleaseSpinLockFromDpcLevel(SpinLock) KefReleaseSpinLockFromDpcLevel(SpinLock)
8188 KeGetCurrentThread(VOID
);
8190 _Always_(_Post_satisfies_(return<=0))
8191 _Must_inspect_result_
8192 _IRQL_requires_max_(DISPATCH_LEVEL
)
8193 _Kernel_float_saved_
8194 _At_(*FloatSave
, _Kernel_requires_resource_not_held_(FloatState
) _Kernel_acquires_resource_(FloatState
))
8198 KeSaveFloatingPointState(
8199 _Out_ PKFLOATING_SAVE FloatSave
);
8202 _Kernel_float_restored_
8203 _At_(*FloatSave
, _Kernel_requires_resource_held_(FloatState
) _Kernel_releases_resource_(FloatState
))
8207 KeRestoreFloatingPointState(
8208 _In_ PKFLOATING_SAVE FloatSave
);
8213 * IN BOOLEAN ReadOperation,
8214 * IN BOOLEAN DmaOperation)
8216 #define KeFlushIoBuffers(_Mdl, _ReadOperation, _DmaOperation)
8218 /* x86 and x64 performs a 0x2C interrupt */
8219 #define DbgRaiseAssertionFailure __int2c
8224 OUT PLARGE_INTEGER CurrentCount
)
8227 #ifdef NONAMELESSUNION
8228 CurrentCount
->s
.HighPart
= KeTickCount
.High1Time
;
8229 CurrentCount
->s
.LowPart
= KeTickCount
.LowPart
;
8230 if (CurrentCount
->s
.HighPart
== KeTickCount
.High2Time
) break;
8232 CurrentCount
->HighPart
= KeTickCount
.High1Time
;
8233 CurrentCount
->LowPart
= KeTickCount
.LowPart
;
8234 if (CurrentCount
->HighPart
== KeTickCount
.High2Time
) break;
8239 #define KeQueryTickCount(CurrentCount) _KeQueryTickCount(CurrentCount)
8245 #elif defined(_M_AMD64)
8246 /** Kernel definitions for AMD64 **/
8248 /* Interrupt request levels */
8249 #define PASSIVE_LEVEL 0
8252 #define DISPATCH_LEVEL 2
8253 #define CMCI_LEVEL 5
8254 #define CLOCK_LEVEL 13
8255 #define IPI_LEVEL 14
8256 #define DRS_LEVEL 14
8257 #define POWER_LEVEL 14
8258 #define PROFILE_LEVEL 15
8259 #define HIGH_LEVEL 15
8261 #define KI_USER_SHARED_DATA 0xFFFFF78000000000ULL
8262 #define SharedUserData ((PKUSER_SHARED_DATA const)KI_USER_SHARED_DATA)
8263 #define SharedInterruptTime (KI_USER_SHARED_DATA + 0x8)
8264 #define SharedSystemTime (KI_USER_SHARED_DATA + 0x14)
8265 #define SharedTickCount (KI_USER_SHARED_DATA + 0x320)
8267 #define PAGE_SIZE 0x1000
8268 #define PAGE_SHIFT 12L
8270 #define EFLAG_SIGN 0x8000
8271 #define EFLAG_ZERO 0x4000
8272 #define EFLAG_SELECT (EFLAG_SIGN | EFLAG_ZERO)
8274 typedef struct _KFLOATING_SAVE
{
8276 } KFLOATING_SAVE
, *PKFLOATING_SAVE
;
8278 typedef XSAVE_FORMAT XMM_SAVE_AREA32
, *PXMM_SAVE_AREA32
;
8280 #define KeQueryInterruptTime() \
8281 (*(volatile ULONG64*)SharedInterruptTime)
8283 #define KeQuerySystemTime(CurrentCount) \
8284 *(ULONG64*)(CurrentCount) = *(volatile ULONG64*)SharedSystemTime
8286 #define KeQueryTickCount(CurrentCount) \
8287 *(ULONG64*)(CurrentCount) = *(volatile ULONG64*)SharedTickCount
8289 #define KeGetDcacheFillSize() 1L
8291 #define YieldProcessor _mm_pause
8292 #define MemoryBarrier __faststorefence
8293 #define FastFence __faststorefence
8294 #define LoadFence _mm_lfence
8295 #define MemoryFence _mm_mfence
8296 #define StoreFence _mm_sfence
8297 #define LFENCE_ACQUIRE() LoadFence()
8301 KeMemoryBarrier(VOID
)
8303 // FIXME: Do we really need lfence after the __faststorefence ?
8308 #define KeMemoryBarrierWithoutFence() _ReadWriteBarrier()
8312 KeGetCurrentIrql(VOID
)
8314 return (KIRQL
)__readcr8();
8319 KeLowerIrql(IN KIRQL NewIrql
)
8321 //ASSERT((KIRQL)__readcr8() >= NewIrql);
8322 __writecr8(NewIrql
);
8327 KfRaiseIrql(IN KIRQL NewIrql
)
8331 OldIrql
= (KIRQL
)__readcr8();
8332 //ASSERT(OldIrql <= NewIrql);
8333 __writecr8(NewIrql
);
8336 #define KeRaiseIrql(a,b) *(b) = KfRaiseIrql(a)
8340 KeRaiseIrqlToDpcLevel(VOID
)
8342 return KfRaiseIrql(DISPATCH_LEVEL
);
8347 KeRaiseIrqlToSynchLevel(VOID
)
8349 return KfRaiseIrql(12); // SYNCH_LEVEL = IPI_LEVEL - 2
8354 KeGetCurrentThread(VOID
)
8356 return (struct _KTHREAD
*)__readgsqword(0x188);
8361 KeSaveFloatingPointState(PVOID FloatingState
)
8363 UNREFERENCED_PARAMETER(FloatingState
);
8364 return STATUS_SUCCESS
;
8369 KeRestoreFloatingPointState(PVOID FloatingState
)
8371 UNREFERENCED_PARAMETER(FloatingState
);
8372 return STATUS_SUCCESS
;
8378 * IN BOOLEAN ReadOperation,
8379 * IN BOOLEAN DmaOperation)
8381 #define KeFlushIoBuffers(_Mdl, _ReadOperation, _DmaOperation)
8383 /* x86 and x64 performs a 0x2C interrupt */
8384 #define DbgRaiseAssertionFailure __int2c
8386 #elif defined(_M_IA64)
8387 /** Kernel definitions for IA64 **/
8389 /* Interrupt request levels */
8390 #define PASSIVE_LEVEL 0
8393 #define DISPATCH_LEVEL 2
8395 #define DEVICE_LEVEL_BASE 4
8397 #define IPI_LEVEL 14
8398 #define DRS_LEVEL 14
8399 #define CLOCK_LEVEL 13
8400 #define POWER_LEVEL 15
8401 #define PROFILE_LEVEL 15
8402 #define HIGH_LEVEL 15
8404 #define KI_USER_SHARED_DATA ((ULONG_PTR)(KADDRESS_BASE + 0xFFFE0000))
8405 extern NTKERNELAPI
volatile LARGE_INTEGER KeTickCount
;
8407 #define PAUSE_PROCESSOR __yield();
8411 KeFlushWriteBuffer(VOID
)
8420 KeGetCurrentThread(VOID
);
8423 #elif defined(_M_PPC)
8425 /* Interrupt request levels */
8426 #define PASSIVE_LEVEL 0
8429 #define DISPATCH_LEVEL 2
8430 #define PROFILE_LEVEL 27
8431 #define CLOCK1_LEVEL 28
8432 #define CLOCK2_LEVEL 28
8433 #define IPI_LEVEL 29
8434 #define POWER_LEVEL 30
8435 #define HIGH_LEVEL 31
8438 // Used to contain PFNs and PFN counts
8440 typedef ULONG PFN_COUNT
;
8441 typedef ULONG PFN_NUMBER
, *PPFN_NUMBER
;
8442 typedef LONG SPFN_NUMBER
, *PSPFN_NUMBER
;
8445 typedef struct _KFLOATING_SAVE
{
8447 } KFLOATING_SAVE
, *PKFLOATING_SAVE
;
8449 typedef struct _KPCR_TIB
{
8450 PVOID ExceptionList
; /* 00 */
8451 PVOID StackBase
; /* 04 */
8452 PVOID StackLimit
; /* 08 */
8453 PVOID SubSystemTib
; /* 0C */
8454 _ANONYMOUS_UNION
union {
8455 PVOID FiberData
; /* 10 */
8456 ULONG Version
; /* 10 */
8458 PVOID ArbitraryUserPointer
; /* 14 */
8459 struct _KPCR_TIB
*Self
; /* 18 */
8460 } KPCR_TIB
, *PKPCR_TIB
; /* 1C */
8462 #define PCR_MINOR_VERSION 1
8463 #define PCR_MAJOR_VERSION 1
8465 typedef struct _KPCR
{
8466 KPCR_TIB Tib
; /* 00 */
8467 struct _KPCR
*Self
; /* 1C */
8468 struct _KPRCB
*Prcb
; /* 20 */
8469 KIRQL Irql
; /* 24 */
8471 ULONG IrrActive
; /* 2C */
8473 PVOID KdVersionBlock
; /* 34 */
8474 PUSHORT IDT
; /* 38 */
8475 PUSHORT GDT
; /* 3C */
8476 struct _KTSS
*TSS
; /* 40 */
8477 USHORT MajorVersion
; /* 44 */
8478 USHORT MinorVersion
; /* 46 */
8479 KAFFINITY SetMember
; /* 48 */
8480 ULONG StallScaleFactor
; /* 4C */
8481 UCHAR SpareUnused
; /* 50 */
8482 UCHAR Number
; /* 51 */
8483 } KPCR
, *PKPCR
; /* 54 */
8485 #define KeGetPcr() PCR
8487 #define YieldProcessor() __asm__ __volatile__("nop");
8492 KeGetCurrentProcessorNumber(VOID
)
8495 __asm__
__volatile__ (
8498 : "i" (FIELD_OFFSET(KPCR
, Number
))
8508 #define KeLowerIrql(a) KfLowerIrql(a)
8515 #define KeRaiseIrql(a,b) *(b) = KfRaiseIrql(a)
8520 KeRaiseIrqlToDpcLevel(VOID
);
8525 KeRaiseIrqlToSynchLevel(VOID
);
8529 #elif defined(_M_MIPS)
8530 #error MIPS Headers are totally incorrect
8533 // Used to contain PFNs and PFN counts
8535 typedef ULONG PFN_COUNT
;
8536 typedef ULONG PFN_NUMBER
, *PPFN_NUMBER
;
8537 typedef LONG SPFN_NUMBER
, *PSPFN_NUMBER
;
8539 #define PASSIVE_LEVEL 0
8541 #define DISPATCH_LEVEL 2
8542 #define PROFILE_LEVEL 27
8543 #define IPI_LEVEL 29
8544 #define HIGH_LEVEL 31
8546 typedef struct _KPCR
{
8547 struct _KPRCB
*Prcb
; /* 20 */
8548 KIRQL Irql
; /* 24 */
8553 #define KeGetPcr() PCR
8555 typedef struct _KFLOATING_SAVE
{
8556 } KFLOATING_SAVE
, *PKFLOATING_SAVE
;
8561 KeGetCurrentProcessorNumber(VOID
)
8566 #define YieldProcessor() __asm__ __volatile__("nop");
8568 #define KeLowerIrql(a) KfLowerIrql(a)
8569 #define KeRaiseIrql(a,b) *(b) = KfRaiseIrql(a)
8586 KeRaiseIrqlToDpcLevel(VOID
);
8591 KeRaiseIrqlToSynchLevel(VOID
);
8594 #elif defined(_M_ARM)
8597 #error Unknown Architecture
8604 _Out_ PRKEVENT Event
,
8605 _In_ EVENT_TYPE Type
,
8606 _In_ BOOLEAN State
);
8608 _IRQL_requires_max_(DISPATCH_LEVEL
)
8613 _Inout_ PRKEVENT Event
);
8615 #if (NTDDI_VERSION >= NTDDI_WIN2K)
8617 #if defined(_NTDDK_) || defined(_NTIFS_)
8618 _Maybe_raises_SEH_exception_
8619 _IRQL_requires_max_(APC_LEVEL
)
8624 __in_data_source(USER_MODE
) _In_reads_bytes_(Length
) CONST VOID
*Address
, /* CONST is added */
8626 _In_ ULONG Alignment
);
8627 #endif /* defined(_NTDDK_) || defined(_NTIFS_) */
8629 _Maybe_raises_SEH_exception_
8630 _IRQL_requires_max_(APC_LEVEL
)
8635 __in_data_source(USER_MODE
) _Out_writes_bytes_(Length
) PVOID Address
,
8637 _In_ ULONG Alignment
);
8639 #if defined(SINGLE_GROUP_LEGACY_API)
8641 _IRQL_requires_min_(PASSIVE_LEVEL
)
8642 _IRQL_requires_max_(APC_LEVEL
)
8646 KeRevertToUserAffinityThread(VOID
);
8648 _IRQL_requires_min_(PASSIVE_LEVEL
)
8649 _IRQL_requires_max_(APC_LEVEL
)
8653 KeSetSystemAffinityThread(
8654 _In_ KAFFINITY Affinity
);
8659 KeSetTargetProcessorDpc(
8666 KeQueryActiveProcessors(VOID
);
8667 #endif /* defined(SINGLE_GROUP_LEGACY_API) */
8669 #if !defined(_M_AMD64)
8673 KeQueryInterruptTime(VOID
);
8679 _Out_ PLARGE_INTEGER CurrentTime
);
8680 #endif /* !_M_AMD64 */
8682 #if !defined(_X86_) && !defined(_M_ARM)
8683 _Requires_lock_not_held_(*SpinLock
)
8684 _Acquires_lock_(*SpinLock
)
8685 _IRQL_requires_max_(DISPATCH_LEVEL
)
8687 _IRQL_raises_(DISPATCH_LEVEL
)
8691 KeAcquireSpinLockRaiseToDpc(
8692 _Inout_ PKSPIN_LOCK SpinLock
);
8694 #define KeAcquireSpinLock(SpinLock, OldIrql) \
8695 *(OldIrql) = KeAcquireSpinLockRaiseToDpc(SpinLock)
8697 _Requires_lock_not_held_(*SpinLock
)
8698 _Acquires_lock_(*SpinLock
)
8699 _IRQL_requires_min_(DISPATCH_LEVEL
)
8703 KeAcquireSpinLockAtDpcLevel(
8704 _Inout_ PKSPIN_LOCK SpinLock
);
8706 _Requires_lock_held_(*SpinLock
)
8707 _Releases_lock_(*SpinLock
)
8708 _IRQL_requires_(DISPATCH_LEVEL
)
8713 _Inout_ PKSPIN_LOCK SpinLock
,
8714 _In_ _IRQL_restores_ KIRQL NewIrql
);
8716 _Requires_lock_held_(*SpinLock
)
8717 _Releases_lock_(*SpinLock
)
8718 _IRQL_requires_min_(DISPATCH_LEVEL
)
8722 KeReleaseSpinLockFromDpcLevel(
8723 _Inout_ PKSPIN_LOCK SpinLock
);
8726 #if defined(_X86_) && (defined(_WDM_INCLUDED_) || defined(WIN9X_COMPAT_SPINLOCK))
8730 KeInitializeSpinLock(
8731 _Out_ PKSPIN_LOCK SpinLock
);
8735 KeInitializeSpinLock(_Out_ PKSPIN_LOCK SpinLock
)
8737 /* Clear the lock */
8747 _In_ ULONG BugCheckCode
,
8748 _In_ ULONG_PTR BugCheckParameter1
,
8749 _In_ ULONG_PTR BugCheckParameter2
,
8750 _In_ ULONG_PTR BugCheckParameter3
,
8751 _In_ ULONG_PTR BugCheckParameter4
);
8753 _IRQL_requires_max_(DISPATCH_LEVEL
)
8760 _IRQL_requires_min_(PASSIVE_LEVEL
)
8761 _IRQL_requires_max_(APC_LEVEL
)
8765 KeDelayExecutionThread(
8766 _In_ KPROCESSOR_MODE WaitMode
,
8767 _In_ BOOLEAN Alertable
,
8768 _In_ PLARGE_INTEGER Interval
);
8770 _Must_inspect_result_
8774 KeDeregisterBugCheckCallback(
8775 _Inout_ PKBUGCHECK_CALLBACK_RECORD CallbackRecord
);
8777 _Acquires_lock_(_Global_critical_region_
)
8778 _IRQL_requires_max_(APC_LEVEL
)
8782 KeEnterCriticalRegion(VOID
);
8784 _IRQL_requires_max_(DISPATCH_LEVEL
)
8788 KeInitializeDeviceQueue(
8789 _Out_ PKDEVICE_QUEUE DeviceQueue
);
8795 _Out_ __drv_aliasesMem PRKDPC Dpc
,
8796 _In_ PKDEFERRED_ROUTINE DeferredRoutine
,
8797 _In_opt_ __drv_aliasesMem PVOID DeferredContext
);
8803 _Out_ PRKMUTEX Mutex
,
8806 _IRQL_requires_max_(PASSIVE_LEVEL
)
8810 KeInitializeSemaphore(
8811 _Out_ PRKSEMAPHORE Semaphore
,
8815 _IRQL_requires_max_(DISPATCH_LEVEL
)
8820 _Out_ PKTIMER Timer
);
8822 _IRQL_requires_max_(DISPATCH_LEVEL
)
8826 KeInitializeTimerEx(
8827 _Out_ PKTIMER Timer
,
8828 _In_ TIMER_TYPE Type
);
8830 _IRQL_requires_(DISPATCH_LEVEL
)
8834 KeInsertByKeyDeviceQueue(
8835 _Inout_ PKDEVICE_QUEUE DeviceQueue
,
8836 _Inout_ PKDEVICE_QUEUE_ENTRY DeviceQueueEntry
,
8837 _In_ ULONG SortKey
);
8839 _IRQL_requires_(DISPATCH_LEVEL
)
8843 KeInsertDeviceQueue(
8844 _Inout_ PKDEVICE_QUEUE DeviceQueue
,
8845 _Inout_ PKDEVICE_QUEUE_ENTRY DeviceQueueEntry
);
8852 _In_opt_ PVOID SystemArgument1
,
8853 _In_opt_ PVOID SystemArgument2
);
8855 _Releases_lock_(_Global_critical_region_
)
8856 _IRQL_requires_max_(APC_LEVEL
)
8860 KeLeaveCriticalRegion(VOID
);
8865 KeQueryPerformanceCounter(
8866 _Out_opt_ PLARGE_INTEGER PerformanceFrequency
);
8868 _IRQL_requires_max_(PASSIVE_LEVEL
)
8872 KeQueryPriorityThread(
8873 _In_ PRKTHREAD Thread
);
8878 KeQueryTimeIncrement(VOID
);
8880 _IRQL_requires_max_(DISPATCH_LEVEL
)
8885 _In_ PRKEVENT Event
);
8887 _IRQL_requires_max_(DISPATCH_LEVEL
)
8892 _In_ PRKMUTEX Mutex
);
8894 _IRQL_requires_max_(DISPATCH_LEVEL
)
8898 KeReadStateSemaphore(
8899 _In_ PRKSEMAPHORE Semaphore
);
8901 _IRQL_requires_max_(DISPATCH_LEVEL
)
8906 _In_ PKTIMER Timer
);
8908 _Must_inspect_result_
8912 KeRegisterBugCheckCallback(
8913 _Out_ PKBUGCHECK_CALLBACK_RECORD CallbackRecord
,
8914 _In_ PKBUGCHECK_CALLBACK_ROUTINE CallbackRoutine
,
8915 _In_reads_bytes_opt_(Length
) PVOID Buffer
,
8917 _In_ PUCHAR Component
);
8919 _When_(Wait
==0, _IRQL_requires_max_(DISPATCH_LEVEL
))
8920 _When_(Wait
==1, _IRQL_requires_max_(APC_LEVEL
))
8925 _Inout_ PRKMUTEX Mutex
,
8928 _When_(Wait
==0, _IRQL_requires_max_(DISPATCH_LEVEL
))
8929 _When_(Wait
==1, _IRQL_requires_max_(APC_LEVEL
))
8934 _Inout_ PRKSEMAPHORE Semaphore
,
8935 _In_ KPRIORITY Increment
,
8936 _In_ LONG Adjustment
,
8937 _In_ _Literal_ BOOLEAN Wait
);
8939 _IRQL_requires_(DISPATCH_LEVEL
)
8941 PKDEVICE_QUEUE_ENTRY
8943 KeRemoveByKeyDeviceQueue(
8944 _Inout_ PKDEVICE_QUEUE DeviceQueue
,
8945 _In_ ULONG SortKey
);
8947 _IRQL_requires_(DISPATCH_LEVEL
)
8949 PKDEVICE_QUEUE_ENTRY
8951 KeRemoveDeviceQueue(
8952 _Inout_ PKDEVICE_QUEUE DeviceQueue
);
8954 _IRQL_requires_max_(DISPATCH_LEVEL
)
8958 KeRemoveEntryDeviceQueue(
8959 _Inout_ PKDEVICE_QUEUE DeviceQueue
,
8960 _Inout_ PKDEVICE_QUEUE_ENTRY DeviceQueueEntry
);
8962 _IRQL_requires_max_(HIGH_LEVEL
)
8967 _Inout_ PRKDPC Dpc
);
8969 _IRQL_requires_max_(DISPATCH_LEVEL
)
8974 _Inout_ PRKEVENT Event
);
8976 _When_(Wait
==0, _IRQL_requires_max_(DISPATCH_LEVEL
))
8977 _When_(Wait
==1, _IRQL_requires_max_(APC_LEVEL
))
8982 _Inout_ PRKEVENT Event
,
8983 _In_ KPRIORITY Increment
,
8984 _In_ _Literal_ BOOLEAN Wait
);
8991 _In_ KDPC_IMPORTANCE Importance
);
8993 _IRQL_requires_min_(PASSIVE_LEVEL
)
8994 _IRQL_requires_max_(DISPATCH_LEVEL
)
8998 KeSetPriorityThread(
8999 _Inout_ PKTHREAD Thread
,
9000 _In_ KPRIORITY Priority
);
9002 _IRQL_requires_max_(DISPATCH_LEVEL
)
9007 _Inout_ PKTIMER Timer
,
9008 _In_ LARGE_INTEGER DueTime
,
9009 _In_opt_ PKDPC Dpc
);
9011 _IRQL_requires_max_(DISPATCH_LEVEL
)
9016 _Inout_ PKTIMER Timer
,
9017 _In_ LARGE_INTEGER DueTime
,
9018 _In_ LONG Period OPTIONAL
,
9019 _In_opt_ PKDPC Dpc
);
9024 KeStallExecutionProcessor(
9025 _In_ ULONG MicroSeconds
);
9027 _IRQL_requires_max_(HIGH_LEVEL
)
9031 KeSynchronizeExecution(
9032 _Inout_ PKINTERRUPT Interrupt
,
9033 _In_ PKSYNCHRONIZE_ROUTINE SynchronizeRoutine
,
9034 _In_opt_ __drv_aliasesMem PVOID SynchronizeContext
);
9036 _IRQL_requires_min_(PASSIVE_LEVEL
)
9037 _When_((Timeout
==NULL
|| Timeout
->QuadPart
!=0), _IRQL_requires_max_(APC_LEVEL
))
9038 _When_((Timeout
!=NULL
&& Timeout
->QuadPart
==0), _IRQL_requires_max_(DISPATCH_LEVEL
))
9042 KeWaitForMultipleObjects(
9044 _In_reads_(Count
) PVOID Object
[],
9045 _In_
__drv_strictTypeMatch(__drv_typeConst
) WAIT_TYPE WaitType
,
9046 _In_
__drv_strictTypeMatch(__drv_typeCond
) KWAIT_REASON WaitReason
,
9047 _In_
__drv_strictType(KPROCESSOR_MODE
/enum _MODE
,__drv_typeConst
) KPROCESSOR_MODE WaitMode
,
9048 _In_ BOOLEAN Alertable
,
9049 _In_opt_ PLARGE_INTEGER Timeout
,
9050 _Out_opt_ PKWAIT_BLOCK WaitBlockArray
);
9052 #define KeWaitForMutexObject KeWaitForSingleObject
9054 _IRQL_requires_min_(PASSIVE_LEVEL
)
9055 _When_((Timeout
==NULL
|| Timeout
->QuadPart
!=0), _IRQL_requires_max_(APC_LEVEL
))
9056 _When_((Timeout
!=NULL
&& Timeout
->QuadPart
==0), _IRQL_requires_max_(DISPATCH_LEVEL
))
9060 KeWaitForSingleObject(
9061 _In_ _Points_to_data_ PVOID Object
,
9062 _In_
__drv_strictTypeMatch(__drv_typeCond
) KWAIT_REASON WaitReason
,
9063 _In_
__drv_strictType(KPROCESSOR_MODE
/enum _MODE
,__drv_typeConst
) KPROCESSOR_MODE WaitMode
,
9064 _In_ BOOLEAN Alertable
,
9065 _In_opt_ PLARGE_INTEGER Timeout
);
9067 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
9069 #if (NTDDI_VERSION >= NTDDI_WINXP)
9071 _Requires_lock_not_held_(*LockHandle
)
9072 _Acquires_lock_(*LockHandle
)
9073 _Post_same_lock_(*SpinLock
, *LockHandle
)
9074 _IRQL_requires_max_(DISPATCH_LEVEL
)
9075 _IRQL_saves_global_(QueuedSpinLock
,LockHandle
)
9076 _IRQL_raises_(DISPATCH_LEVEL
)
9080 KeAcquireInStackQueuedSpinLock(
9081 _Inout_ PKSPIN_LOCK SpinLock
,
9082 _Out_ PKLOCK_QUEUE_HANDLE LockHandle
);
9084 _Requires_lock_not_held_(*LockHandle
)
9085 _Acquires_lock_(*LockHandle
)
9086 _Post_same_lock_(*SpinLock
, *LockHandle
)
9087 _IRQL_requires_min_(DISPATCH_LEVEL
)
9091 KeAcquireInStackQueuedSpinLockAtDpcLevel(
9092 _Inout_ PKSPIN_LOCK SpinLock
,
9093 _Out_ PKLOCK_QUEUE_HANDLE LockHandle
);
9095 _Requires_lock_not_held_(*Interrupt
->ActualLock
)
9096 _Acquires_lock_(*Interrupt
->ActualLock
)
9097 _IRQL_requires_max_(HIGH_LEVEL
)
9099 _IRQL_raises_(HIGH_LEVEL
)
9103 KeAcquireInterruptSpinLock(
9104 _Inout_ PKINTERRUPT Interrupt
);
9106 _IRQL_requires_min_(PASSIVE_LEVEL
)
9107 _IRQL_requires_max_(DISPATCH_LEVEL
)
9111 KeAreApcsDisabled(VOID
);
9116 KeGetRecommendedSharedDataAlignment(VOID
);
9118 _IRQL_requires_max_(PASSIVE_LEVEL
)
9122 KeQueryRuntimeThread(
9123 _In_ PKTHREAD Thread
,
9124 _Out_ PULONG UserTime
);
9126 _Requires_lock_held_(*LockHandle
)
9127 _Releases_lock_(*LockHandle
)
9128 _IRQL_requires_(DISPATCH_LEVEL
)
9132 KeReleaseInStackQueuedSpinLockFromDpcLevel(
9133 _In_ PKLOCK_QUEUE_HANDLE LockHandle
);
9135 _Requires_lock_held_(*Interrupt
->ActualLock
)
9136 _Releases_lock_(*Interrupt
->ActualLock
)
9137 _IRQL_requires_(HIGH_LEVEL
)
9141 KeReleaseInterruptSpinLock(
9142 _Inout_ PKINTERRUPT Interrupt
,
9143 _In_ _IRQL_restores_ KIRQL OldIrql
);
9145 _IRQL_requires_(DISPATCH_LEVEL
)
9147 PKDEVICE_QUEUE_ENTRY
9149 KeRemoveByKeyDeviceQueueIfBusy(
9150 _Inout_ PKDEVICE_QUEUE DeviceQueue
,
9151 _In_ ULONG SortKey
);
9153 _Requires_lock_held_(*LockHandle
)
9154 _Releases_lock_(*LockHandle
)
9155 _IRQL_requires_(DISPATCH_LEVEL
)
9156 _IRQL_restores_global_(QueuedSpinLock
,LockHandle
)
9160 KeReleaseInStackQueuedSpinLock(
9161 _In_ PKLOCK_QUEUE_HANDLE LockHandle
);
9163 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) */
9165 #if (NTDDI_VERSION >= NTDDI_WINXPSP1)
9167 _Must_inspect_result_
9171 KeDeregisterBugCheckReasonCallback(
9172 _Inout_ PKBUGCHECK_REASON_CALLBACK_RECORD CallbackRecord
);
9174 _Must_inspect_result_
9178 KeRegisterBugCheckReasonCallback(
9179 _Out_ PKBUGCHECK_REASON_CALLBACK_RECORD CallbackRecord
,
9180 _In_ PKBUGCHECK_REASON_CALLBACK_ROUTINE CallbackRoutine
,
9181 _In_ KBUGCHECK_CALLBACK_REASON Reason
,
9182 _In_ PUCHAR Component
);
9184 #endif /* (NTDDI_VERSION >= NTDDI_WINXPSP1) */
9186 #if (NTDDI_VERSION >= NTDDI_WINXPSP2)
9187 _IRQL_requires_max_(APC_LEVEL
)
9191 KeFlushQueuedDpcs(VOID
);
9192 #endif /* (NTDDI_VERSION >= NTDDI_WINXPSP2) */
9193 #if (NTDDI_VERSION >= NTDDI_WS03)
9195 _IRQL_requires_max_(APC_LEVEL
)
9199 KeRegisterNmiCallback(
9200 _In_ PNMI_CALLBACK CallbackRoutine
,
9201 _In_opt_ PVOID Context
);
9203 _IRQL_requires_max_(APC_LEVEL
)
9207 KeDeregisterNmiCallback(
9213 KeInitializeThreadedDpc(
9215 _In_ PKDEFERRED_ROUTINE DeferredRoutine
,
9216 _In_opt_ PVOID DeferredContext
);
9218 _IRQL_requires_min_(PASSIVE_LEVEL
)
9219 _IRQL_requires_max_(IPI_LEVEL
-1)
9224 _In_ PKIPI_BROADCAST_WORKER BroadcastFunction
,
9225 _In_ ULONG_PTR Context
);
9227 _Requires_lock_not_held_(*SpinLock
)
9228 _Acquires_lock_(*SpinLock
)
9229 _IRQL_requires_max_(DISPATCH_LEVEL
)
9234 KeAcquireSpinLockForDpc(
9235 _Inout_ PKSPIN_LOCK SpinLock
);
9237 _Requires_lock_held_(*SpinLock
)
9238 _Releases_lock_(*SpinLock
)
9239 _IRQL_requires_(DISPATCH_LEVEL
)
9243 KeReleaseSpinLockForDpc(
9244 _Inout_ PKSPIN_LOCK SpinLock
,
9245 _In_ _IRQL_restores_ KIRQL OldIrql
);
9247 _Must_inspect_result_
9252 _In_ PKSPIN_LOCK SpinLock
);
9254 #endif /* (NTDDI_VERSION >= NTDDI_WS03) */
9255 #if (NTDDI_VERSION >= NTDDI_WS03SP1)
9257 _Must_inspect_result_
9258 _IRQL_requires_min_(DISPATCH_LEVEL
)
9259 _Post_satisfies_(return == 1 || return == 0)
9263 KeTryToAcquireSpinLockAtDpcLevel(
9264 _Inout_
_Requires_lock_not_held_(*_Curr_
)
9265 _When_(return!=0, _Acquires_lock_(*_Curr_
))
9266 PKSPIN_LOCK SpinLock
);
9268 _IRQL_requires_min_(PASSIVE_LEVEL
)
9269 _IRQL_requires_max_(DISPATCH_LEVEL
)
9273 KeAreAllApcsDisabled(VOID
);
9275 _Acquires_lock_(_Global_critical_region_
)
9276 _Requires_lock_not_held_(*Mutex
)
9277 _Acquires_lock_(*Mutex
)
9278 _IRQL_requires_max_(APC_LEVEL
)
9279 _IRQL_requires_min_(PASSIVE_LEVEL
)
9283 KeAcquireGuardedMutex(
9284 _Inout_ PKGUARDED_MUTEX GuardedMutex
);
9286 _Requires_lock_not_held_(*FastMutex
)
9287 _Acquires_lock_(*FastMutex
)
9288 _IRQL_requires_max_(APC_LEVEL
)
9289 _IRQL_requires_min_(PASSIVE_LEVEL
)
9293 KeAcquireGuardedMutexUnsafe(
9294 _Inout_ PKGUARDED_MUTEX GuardedMutex
);
9296 _Acquires_lock_(_Global_critical_region_
)
9297 _IRQL_requires_max_(APC_LEVEL
)
9301 KeEnterGuardedRegion(VOID
);
9303 _Releases_lock_(_Global_critical_region_
)
9304 _IRQL_requires_max_(APC_LEVEL
)
9308 KeLeaveGuardedRegion(VOID
);
9310 _IRQL_requires_max_(APC_LEVEL
)
9311 _IRQL_requires_min_(PASSIVE_LEVEL
)
9315 KeInitializeGuardedMutex(
9316 _Out_ PKGUARDED_MUTEX GuardedMutex
);
9318 _Requires_lock_held_(*FastMutex
)
9319 _Releases_lock_(*FastMutex
)
9320 _IRQL_requires_max_(APC_LEVEL
)
9324 KeReleaseGuardedMutexUnsafe(
9325 _Inout_ PKGUARDED_MUTEX GuardedMutex
);
9327 _Releases_lock_(_Global_critical_region_
)
9328 _Requires_lock_held_(*Mutex
)
9329 _Releases_lock_(*Mutex
)
9330 _IRQL_requires_max_(APC_LEVEL
)
9334 KeReleaseGuardedMutex(
9335 _Inout_ PKGUARDED_MUTEX GuardedMutex
);
9337 _Must_inspect_result_
9338 _Success_(return != FALSE
)
9339 _IRQL_requires_max_(APC_LEVEL
)
9340 _Post_satisfies_(return == 1 || return == 0)
9344 KeTryToAcquireGuardedMutex(
9345 _When_ (return, _Requires_lock_not_held_(*_Curr_
) _Acquires_exclusive_lock_(*_Curr_
)) _Acquires_lock_(_Global_critical_region_
)
9346 _Inout_ PKGUARDED_MUTEX GuardedMutex
);
9347 #endif /* (NTDDI_VERSION >= NTDDI_WS03SP1) */
9349 #if (NTDDI_VERSION >= NTDDI_VISTA)
9350 _Requires_lock_not_held_(*LockHandle
)
9351 _Acquires_lock_(*LockHandle
)
9352 _Post_same_lock_(*SpinLock
, *LockHandle
)
9353 _IRQL_requires_max_(DISPATCH_LEVEL
)
9354 _IRQL_saves_global_(QueuedSpinLock
,LockHandle
)
9358 KeAcquireInStackQueuedSpinLockForDpc(
9359 _Inout_ PKSPIN_LOCK SpinLock
,
9360 _Out_ PKLOCK_QUEUE_HANDLE LockHandle
);
9362 _Requires_lock_held_(*LockHandle
)
9363 _Releases_lock_(*LockHandle
)
9364 _IRQL_requires_(DISPATCH_LEVEL
)
9365 _IRQL_restores_global_(QueuedSpinLock
,LockHandle
)
9369 KeReleaseInStackQueuedSpinLockForDpc(
9370 _In_ PKLOCK_QUEUE_HANDLE LockHandle
);
9372 _IRQL_requires_(DISPATCH_LEVEL
)
9376 KeQueryDpcWatchdogInformation(
9377 _Out_ PKDPC_WATCHDOG_INFORMATION WatchdogInformation
);
9378 #if defined(SINGLE_GROUP_LEGACY_API)
9380 _IRQL_requires_min_(PASSIVE_LEVEL
)
9381 _IRQL_requires_max_(APC_LEVEL
)
9385 KeSetSystemAffinityThreadEx(
9386 _In_ KAFFINITY Affinity
);
9388 _IRQL_requires_min_(PASSIVE_LEVEL
)
9389 _IRQL_requires_max_(APC_LEVEL
)
9393 KeRevertToUserAffinityThreadEx(
9394 _In_ KAFFINITY Affinity
);
9399 KeQueryActiveProcessorCount(
9400 _Out_opt_ PKAFFINITY ActiveProcessors
);
9405 KeQueryMaximumProcessorCount(VOID
);
9406 #endif /* SINGLE_GROUP_LEGACY_API */
9408 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
9410 #if (NTDDI_VERSION >= NTDDI_WS08)
9412 _IRQL_requires_max_(APC_LEVEL
)
9415 KeRegisterProcessorChangeCallback(
9416 _In_ PPROCESSOR_CALLBACK_FUNCTION CallbackFunction
,
9417 _In_opt_ PVOID CallbackContext
,
9420 _IRQL_requires_max_(APC_LEVEL
)
9423 KeDeregisterProcessorChangeCallback(
9424 _In_ PVOID CallbackHandle
);
9426 #endif /* (NTDDI_VERSION >= NTDDI_WS08) */
9427 #if (NTDDI_VERSION >= NTDDI_WIN7)
9429 _IRQL_requires_max_(DISPATCH_LEVEL
)
9430 _IRQL_requires_min_(PASSIVE_LEVEL
)
9431 _IRQL_requires_same_
9434 KeQueryTotalCycleTimeProcess(
9435 _Inout_ PKPROCESS Process
,
9436 _Out_ PULONG64 CycleTimeStamp
);
9438 _IRQL_requires_max_(APC_LEVEL
)
9439 _IRQL_requires_min_(PASSIVE_LEVEL
)
9440 _IRQL_requires_same_
9443 KeQueryTotalCycleTimeThread(
9444 _Inout_ PKTHREAD Thread
,
9445 _Out_ PULONG64 CycleTimeStamp
);
9447 _Must_inspect_result_
9451 KeSetTargetProcessorDpcEx(
9453 _In_ PPROCESSOR_NUMBER ProcNumber
);
9455 _IRQL_requires_min_(PASSIVE_LEVEL
)
9456 _IRQL_requires_max_(APC_LEVEL
)
9460 KeSetSystemGroupAffinityThread(
9461 _In_ PGROUP_AFFINITY Affinity
,
9462 _Out_opt_ PGROUP_AFFINITY PreviousAffinity
);
9464 _IRQL_requires_min_(PASSIVE_LEVEL
)
9465 _IRQL_requires_max_(APC_LEVEL
)
9469 KeRevertToUserGroupAffinityThread(
9470 _In_ PGROUP_AFFINITY PreviousAffinity
);
9472 _IRQL_requires_max_(DISPATCH_LEVEL
)
9476 KeSetCoalescableTimer(
9477 _Inout_ PKTIMER Timer
,
9478 _In_ LARGE_INTEGER DueTime
,
9480 _In_ ULONG TolerableDelay
,
9481 _In_opt_ PKDPC Dpc
);
9486 KeQueryUnbiasedInterruptTime(VOID
);
9491 KeQueryActiveProcessorCountEx(
9492 _In_ USHORT GroupNumber
);
9497 KeQueryMaximumProcessorCountEx(
9498 _In_ USHORT GroupNumber
);
9503 KeQueryActiveGroupCount(VOID
);
9508 KeQueryMaximumGroupCount(VOID
);
9513 KeQueryGroupAffinity(
9514 _In_ USHORT GroupNumber
);
9519 KeGetCurrentProcessorNumberEx(
9520 _Out_opt_ PPROCESSOR_NUMBER ProcNumber
);
9525 KeQueryNodeActiveAffinity(
9526 _In_ USHORT NodeNumber
,
9527 _Out_opt_ PGROUP_AFFINITY Affinity
,
9528 _Out_opt_ PUSHORT Count
);
9533 KeQueryNodeMaximumProcessorCount(
9534 _In_ USHORT NodeNumber
);
9539 KeQueryHighestNodeNumber(VOID
);
9544 KeGetCurrentNodeNumber(VOID
);
9546 _IRQL_requires_max_(DISPATCH_LEVEL
)
9550 KeQueryLogicalProcessorRelationship(
9551 _In_opt_ PPROCESSOR_NUMBER ProcessorNumber OPTIONAL
,
9552 _In_ LOGICAL_PROCESSOR_RELATIONSHIP RelationshipType
,
9553 _Out_writes_bytes_opt_(*Length
) PSYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX Information
,
9554 _Inout_ PULONG Length
);
9556 _Must_inspect_result_
9557 _IRQL_requires_max_(DISPATCH_LEVEL
)
9559 _When_(return==0, _Kernel_float_saved_
)
9563 KeSaveExtendedProcessorState(
9565 _Out_
_Requires_lock_not_held_(*_Curr_
)
9566 _When_(return==0, _Acquires_lock_(*_Curr_
))
9567 PXSTATE_SAVE XStateSave
);
9569 _Kernel_float_restored_
9573 KeRestoreExtendedProcessorState(
9574 _In_
_Requires_lock_held_(*_Curr_
) _Releases_lock_(*_Curr_
)
9575 PXSTATE_SAVE XStateSave
);
9579 KeGetProcessorNumberFromIndex(
9580 _In_ ULONG ProcIndex
,
9581 _Out_ PPROCESSOR_NUMBER ProcNumber
);
9585 KeGetProcessorIndexFromNumber(
9586 _In_ PPROCESSOR_NUMBER ProcNumber
);
9587 #endif /* (NTDDI_VERSION >= NTDDI_WIN7) */
9588 #if !defined(_IA64_)
9592 KeFlushWriteBuffer(VOID
);
9596 * KeInitializeCallbackRecord(
9597 * IN PKBUGCHECK_CALLBACK_RECORD CallbackRecord)
9599 #define KeInitializeCallbackRecord(CallbackRecord) \
9600 CallbackRecord->State = BufferEmpty;
9602 #if defined(_PREFAST_)
9604 void __PREfastPagedCode(void);
9605 void __PREfastPagedCodeLocked(void);
9606 #define PAGED_CODE() __PREfastPagedCode();
9607 #define PAGED_CODE_LOCKED() __PREfastPagedCodeLocked();
9611 #if (NTDDI_VERSION >= NTDDI_VISTA)
9612 #define PAGED_ASSERT( exp ) NT_ASSERT( exp )
9614 #define PAGED_ASSERT( exp ) ASSERT( exp )
9617 #define PAGED_CODE() { \
9618 if (KeGetCurrentIrql() > APC_LEVEL) { \
9619 KdPrint( ("NTDDK: Pageable code called at IRQL > APC_LEVEL (%d)\n", KeGetCurrentIrql() )); \
9620 PAGED_ASSERT(FALSE); \
9624 #define PAGED_CODE_LOCKED() NOP_FUNCTION;
9628 #define PAGED_CODE() NOP_FUNCTION;
9629 #define PAGED_CODE_LOCKED() NOP_FUNCTION;
9633 /******************************************************************************
9634 * Runtime Library Functions *
9635 ******************************************************************************/
9638 #if !defined(MIDL_PASS) && !defined(SORTPP_PASS)
9640 #define RTL_STATIC_LIST_HEAD(x) LIST_ENTRY x = { &x, &x }
9645 _Out_ PLIST_ENTRY ListHead
)
9647 ListHead
->Flink
= ListHead
->Blink
= ListHead
;
9650 _Must_inspect_result_
9654 _In_
const LIST_ENTRY
* ListHead
)
9656 return (BOOLEAN
)(ListHead
->Flink
== ListHead
);
9662 _In_ PLIST_ENTRY Entry
)
9664 PLIST_ENTRY OldFlink
;
9665 PLIST_ENTRY OldBlink
;
9667 OldFlink
= Entry
->Flink
;
9668 OldBlink
= Entry
->Blink
;
9669 OldFlink
->Blink
= OldBlink
;
9670 OldBlink
->Flink
= OldFlink
;
9671 return (BOOLEAN
)(OldFlink
== OldBlink
);
9677 _Inout_ PLIST_ENTRY ListHead
)
9682 Entry
= ListHead
->Flink
;
9683 Flink
= Entry
->Flink
;
9684 ListHead
->Flink
= Flink
;
9685 Flink
->Blink
= ListHead
;
9692 _Inout_ PLIST_ENTRY ListHead
)
9697 Entry
= ListHead
->Blink
;
9698 Blink
= Entry
->Blink
;
9699 ListHead
->Blink
= Blink
;
9700 Blink
->Flink
= ListHead
;
9707 _Inout_ PLIST_ENTRY ListHead
,
9708 _Inout_ __drv_aliasesMem PLIST_ENTRY Entry
)
9710 PLIST_ENTRY OldBlink
;
9711 OldBlink
= ListHead
->Blink
;
9712 Entry
->Flink
= ListHead
;
9713 Entry
->Blink
= OldBlink
;
9714 OldBlink
->Flink
= Entry
;
9715 ListHead
->Blink
= Entry
;
9721 _Inout_ PLIST_ENTRY ListHead
,
9722 _Inout_ __drv_aliasesMem PLIST_ENTRY Entry
)
9724 PLIST_ENTRY OldFlink
;
9725 OldFlink
= ListHead
->Flink
;
9726 Entry
->Flink
= OldFlink
;
9727 Entry
->Blink
= ListHead
;
9728 OldFlink
->Blink
= Entry
;
9729 ListHead
->Flink
= Entry
;
9735 _Inout_ PLIST_ENTRY ListHead
,
9736 _Inout_ PLIST_ENTRY ListToAppend
)
9738 PLIST_ENTRY ListEnd
= ListHead
->Blink
;
9740 ListHead
->Blink
->Flink
= ListToAppend
;
9741 ListHead
->Blink
= ListToAppend
->Blink
;
9742 ListToAppend
->Blink
->Flink
= ListHead
;
9743 ListToAppend
->Blink
= ListEnd
;
9749 _Inout_ PSINGLE_LIST_ENTRY ListHead
)
9751 PSINGLE_LIST_ENTRY FirstEntry
;
9752 FirstEntry
= ListHead
->Next
;
9753 if (FirstEntry
!= NULL
) {
9754 ListHead
->Next
= FirstEntry
->Next
;
9762 _Inout_ PSINGLE_LIST_ENTRY ListHead
,
9763 _Inout_ __drv_aliasesMem PSINGLE_LIST_ENTRY Entry
)
9765 Entry
->Next
= ListHead
->Next
;
9766 ListHead
->Next
= Entry
;
9769 #endif /* !defined(MIDL_PASS) && !defined(SORTPP_PASS) */
9776 _In_ PVOID FailedAssertion
,
9777 _In_ PVOID FileName
,
9778 _In_ ULONG LineNumber
,
9779 _In_opt_z_ PSTR Message
);
9783 * IN VOID UNALIGNED *Destination,
9784 * IN CONST VOID UNALIGNED *Source,
9787 #define RtlCopyMemory(Destination, Source, Length) \
9788 memcpy(Destination, Source, Length)
9790 #define RtlCopyBytes RtlCopyMemory
9792 #if defined(_M_AMD64)
9796 RtlCopyMemoryNonTemporal(
9797 _Out_writes_bytes_all_(Length
) VOID UNALIGNED
*Destination
,
9798 _In_reads_bytes_(Length
) const VOID UNALIGNED
*Source
,
9799 _In_ SIZE_T Length
);
9801 #define RtlCopyMemoryNonTemporal RtlCopyMemory
9809 #define RtlEqualLuid(Luid1, Luid2) \
9810 (((Luid1)->LowPart == (Luid2)->LowPart) && ((Luid1)->HighPart == (Luid2)->HighPart))
9814 * IN VOID UNALIGNED *Destination,
9815 * IN CONST VOID UNALIGNED *Source,
9818 #define RtlEqualMemory(Destination, Source, Length) \
9819 (!memcmp(Destination, Source, Length))
9823 * IN VOID UNALIGNED *Destination,
9827 #define RtlFillMemory(Destination, Length, Fill) \
9828 memset(Destination, Fill, Length)
9830 #define RtlFillBytes RtlFillMemory
9832 _IRQL_requires_max_(PASSIVE_LEVEL
)
9836 RtlFreeUnicodeString(
9837 _Inout_
_At_(UnicodeString
->Buffer
, __drv_freesMem(Mem
))
9838 PUNICODE_STRING UnicodeString
);
9840 _IRQL_requires_max_(PASSIVE_LEVEL
)
9841 _Must_inspect_result_
9846 _In_ PUNICODE_STRING GuidString
,
9849 _IRQL_requires_max_(DISPATCH_LEVEL
)
9850 _At_(DestinationString
->Buffer
, _Post_equal_to_(SourceString
))
9851 _When_(SourceString
!= NULL
,
9852 _At_(DestinationString
->Length
, _Post_equal_to_(_String_length_(SourceString
) * sizeof(WCHAR
)))
9853 _At_(DestinationString
->MaximumLength
, _Post_equal_to_(DestinationString
->Length
+ sizeof(WCHAR
))))
9854 _When_(SourceString
== NULL
,
9855 _At_(DestinationString
->Length
, _Post_equal_to_(0))
9856 _At_(DestinationString
->MaximumLength
, _Post_equal_to_(0)))
9860 RtlInitUnicodeString(
9861 _Out_ PUNICODE_STRING DestinationString
,
9862 _In_opt_z_ __drv_aliasesMem PCWSTR SourceString
);
9866 * IN VOID UNALIGNED *Destination,
9867 * IN CONST VOID UNALIGNED *Source,
9870 #define RtlMoveMemory(Destination, Source, Length) \
9871 memmove(Destination, Source, Length)
9873 _IRQL_requires_max_(PASSIVE_LEVEL
)
9874 _Must_inspect_result_
9880 _Out_
_At_(GuidString
->Buffer
, __drv_allocatesMem(Mem
))
9881 PUNICODE_STRING GuidString
);
9885 * IN VOID UNALIGNED *Destination,
9888 #define RtlZeroMemory(Destination, Length) \
9889 memset(Destination, 0, Length)
9891 #define RtlZeroBytes RtlZeroMemory
9893 #if (NTDDI_VERSION >= NTDDI_WIN2K)
9895 _Must_inspect_result_
9900 _In_ PRTL_BITMAP BitMapHeader
,
9901 _In_ ULONG StartingIndex
,
9904 _Must_inspect_result_
9909 _In_ PRTL_BITMAP BitMapHeader
,
9910 _In_ ULONG StartingIndex
,
9913 _IRQL_requires_max_(PASSIVE_LEVEL
)
9914 _Must_inspect_result_
9918 RtlAnsiStringToUnicodeString(
9919 _When_(AllocateDestinationString
, _Out_
_At_(DestinationString
->Buffer
, __drv_allocatesMem(Mem
)))
9920 _When_(!AllocateDestinationString
, _Inout_
)
9921 PUNICODE_STRING DestinationString
,
9922 _In_ PANSI_STRING SourceString
,
9923 _In_ BOOLEAN AllocateDestinationString
);
9925 _IRQL_requires_max_(PASSIVE_LEVEL
)
9929 RtlxAnsiStringToUnicodeSize(
9930 _In_ PCANSI_STRING AnsiString
);
9932 #define RtlAnsiStringToUnicodeSize(String) ( \
9933 NLS_MB_CODE_PAGE_TAG ? \
9934 RtlxAnsiStringToUnicodeSize(String) : \
9935 ((String)->Length + sizeof(ANSI_NULL)) * sizeof(WCHAR) \
9939 _Unchanged_(Destination
->MaximumLength
)
9940 _Unchanged_(Destination
->Buffer
)
9941 _When_(_Old_(Destination
->Length
) + Source
->Length
<= Destination
->MaximumLength
,
9942 _At_(Destination
->Length
, _Post_equal_to_(_Old_(Destination
->Length
) + Source
->Length
))
9943 _At_(return, _Out_range_(==, 0)))
9944 _When_(_Old_(Destination
->Length
) + Source
->Length
> Destination
->MaximumLength
,
9945 _Unchanged_(Destination
->Length
)
9946 _At_(return, _Out_range_(<, 0)))
9950 RtlAppendUnicodeStringToString(
9951 _Inout_ PUNICODE_STRING Destination
,
9952 _In_ PCUNICODE_STRING Source
);
9955 _Unchanged_(Destination
->MaximumLength
)
9956 _Unchanged_(Destination
->Buffer
)
9957 /* _When_(_Old_(Destination->Length) + _String_length_(Source) * sizeof(WCHAR) <= Destination->MaximumLength,
9958 _At_(Destination->Length, _Post_equal_to_(_Old_(Destination->Length) + _String_length_(Source) * sizeof(WCHAR)))
9959 _At_(return, _Out_range_(==, 0)))
9960 _When_(_Old_(Destination->Length) + _String_length_(Source) * sizeof(WCHAR) > Destination->MaximumLength,
9961 _Unchanged_(Destination->Length)
9962 _At_(return, _Out_range_(<, 0))) */
9966 RtlAppendUnicodeToString(
9967 _Inout_ PUNICODE_STRING Destination
,
9968 _In_opt_z_ PCWSTR Source
);
9970 _IRQL_requires_max_(PASSIVE_LEVEL
)
9971 _Must_inspect_result_
9975 RtlCheckRegistryKey(
9976 _In_ ULONG RelativeTo
,
9983 _In_ PRTL_BITMAP BitMapHeader
);
9989 _In_ PRTL_BITMAP BitMapHeader
,
9990 _In_range_(0, BitMapHeader
->SizeOfBitMap
- NumberToClear
) ULONG StartingIndex
,
9991 _In_range_(0, BitMapHeader
->SizeOfBitMap
- StartingIndex
) ULONG NumberToClear
);
9993 _Must_inspect_result_
9998 _In_
const VOID
*Source1
,
9999 _In_
const VOID
*Source2
,
10000 _In_ SIZE_T Length
);
10002 _IRQL_requires_max_(PASSIVE_LEVEL
)
10003 _Must_inspect_result_
10007 RtlCompareUnicodeString(
10008 _In_ PCUNICODE_STRING String1
,
10009 _In_ PCUNICODE_STRING String2
,
10010 _In_ BOOLEAN CaseInSensitive
);
10012 _IRQL_requires_max_(PASSIVE_LEVEL
)
10013 _Must_inspect_result_
10017 RtlCompareUnicodeStrings(
10018 _In_reads_(String1Length
) PCWCH String1
,
10019 _In_ SIZE_T String1Length
,
10020 _In_reads_(String2Length
) PCWCH String2
,
10021 _In_ SIZE_T String2Length
,
10022 _In_ BOOLEAN CaseInSensitive
);
10024 _Unchanged_(DestinationString
->Buffer
)
10025 _Unchanged_(DestinationString
->MaximumLength
)
10026 _At_(DestinationString
->Length
,
10027 _When_(SourceString
->Length
> DestinationString
->MaximumLength
,
10028 _Post_equal_to_(DestinationString
->MaximumLength
))
10029 _When_(SourceString
->Length
<= DestinationString
->MaximumLength
,
10030 _Post_equal_to_(SourceString
->Length
)))
10034 RtlCopyUnicodeString(
10035 _Inout_ PUNICODE_STRING DestinationString
,
10036 _In_opt_ PCUNICODE_STRING SourceString
);
10038 _IRQL_requires_max_(PASSIVE_LEVEL
)
10042 RtlCreateRegistryKey(
10043 _In_ ULONG RelativeTo
,
10046 _IRQL_requires_max_(APC_LEVEL
)
10050 RtlCreateSecurityDescriptor(
10051 _Out_ PSECURITY_DESCRIPTOR SecurityDescriptor
,
10052 _In_ ULONG Revision
);
10054 _IRQL_requires_max_(PASSIVE_LEVEL
)
10058 RtlDeleteRegistryValue(
10059 _In_ ULONG RelativeTo
,
10061 _In_z_ PCWSTR ValueName
);
10063 _IRQL_requires_max_(PASSIVE_LEVEL
)
10064 _Must_inspect_result_
10068 RtlEqualUnicodeString(
10069 _In_ CONST UNICODE_STRING
*String1
,
10070 _In_ CONST UNICODE_STRING
*String2
,
10071 _In_ BOOLEAN CaseInSensitive
);
10073 #if !defined(_AMD64_) && !defined(_IA64_)
10077 RtlExtendedIntegerMultiply(
10078 _In_ LARGE_INTEGER Multiplicand
,
10079 _In_ LONG Multiplier
);
10084 RtlExtendedLargeIntegerDivide(
10085 _In_ LARGE_INTEGER Dividend
,
10086 _In_ ULONG Divisor
,
10087 _Out_opt_ PULONG Remainder
);
10090 #if defined(_X86_) || defined(_IA64_)
10094 RtlExtendedMagicDivide(
10095 _In_ LARGE_INTEGER Dividend
,
10096 _In_ LARGE_INTEGER MagicDivisor
,
10097 _In_ CCHAR ShiftCount
);
10100 _IRQL_requires_max_(PASSIVE_LEVEL
)
10105 _Inout_
_At_(AnsiString
->Buffer
, __drv_freesMem(Mem
))
10106 PANSI_STRING AnsiString
);
10108 _Success_(return != -1)
10109 _Must_inspect_result_
10114 _In_ PRTL_BITMAP BitMapHeader
,
10115 _In_ ULONG NumberToFind
,
10116 _In_ ULONG HintIndex
);
10118 _Success_(return != -1)
10122 RtlFindClearBitsAndSet(
10123 _In_ PRTL_BITMAP BitMapHeader
,
10124 _In_ ULONG NumberToFind
,
10125 _In_ ULONG HintIndex
);
10130 RtlFindFirstRunClear(
10131 _In_ PRTL_BITMAP BitMapHeader
,
10132 _Out_ PULONG StartingIndex
);
10138 _In_ PRTL_BITMAP BitMapHeader
,
10139 _Out_writes_to_(SizeOfRunArray
, return) PRTL_BITMAP_RUN RunArray
,
10140 _In_range_(>, 0) ULONG SizeOfRunArray
,
10141 _In_ BOOLEAN LocateLongestRuns
);
10146 RtlFindLastBackwardRunClear(
10147 _In_ PRTL_BITMAP BitMapHeader
,
10148 _In_ ULONG FromIndex
,
10149 _Out_ PULONG StartingRunIndex
);
10151 _Success_(return != -1)
10152 _Must_inspect_result_
10156 RtlFindLeastSignificantBit(
10157 _In_ ULONGLONG Set
);
10162 RtlFindLongestRunClear(
10163 _In_ PRTL_BITMAP BitMapHeader
,
10164 _Out_ PULONG StartingIndex
);
10166 _Success_(return != -1)
10167 _Must_inspect_result_
10171 RtlFindMostSignificantBit(
10172 _In_ ULONGLONG Set
);
10177 RtlFindNextForwardRunClear(
10178 _In_ PRTL_BITMAP BitMapHeader
,
10179 _In_ ULONG FromIndex
,
10180 _Out_ PULONG StartingRunIndex
);
10182 _Success_(return != -1)
10183 _Must_inspect_result_
10188 _In_ PRTL_BITMAP BitMapHeader
,
10189 _In_ ULONG NumberToFind
,
10190 _In_ ULONG HintIndex
);
10192 _Success_(return != -1)
10196 RtlFindSetBitsAndClear(
10197 _In_ PRTL_BITMAP BitMapHeader
,
10198 _In_ ULONG NumberToFind
,
10199 _In_ ULONG HintIndex
);
10201 _IRQL_requires_max_(DISPATCH_LEVEL
)
10206 _Out_ PANSI_STRING DestinationString
,
10207 _In_opt_z_ __drv_aliasesMem PCSZ SourceString
);
10209 _At_(BitMapHeader
->SizeOfBitMap
, _Post_equal_to_(SizeOfBitMap
))
10210 _At_(BitMapHeader
->Buffer
, _Post_equal_to_(BitMapBuffer
))
10214 RtlInitializeBitMap(
10215 _Out_ PRTL_BITMAP BitMapHeader
,
10216 _In_opt_ __drv_aliasesMem PULONG BitMapBuffer
,
10217 _In_opt_ ULONG SizeOfBitMap
);
10219 _IRQL_requires_max_(DISPATCH_LEVEL
)
10224 _Out_ PSTRING DestinationString
,
10225 _In_opt_z_ __drv_aliasesMem PCSZ SourceString
);
10227 _IRQL_requires_max_(PASSIVE_LEVEL
)
10228 _At_(String
->MaximumLength
, _Const_
)
10232 RtlIntegerToUnicodeString(
10234 _In_opt_ ULONG Base
,
10235 _Inout_ PUNICODE_STRING String
);
10237 _IRQL_requires_max_(PASSIVE_LEVEL
)
10238 _At_(String
->MaximumLength
, _Const_
)
10242 RtlInt64ToUnicodeString(
10243 _In_ ULONGLONG Value
,
10244 _In_opt_ ULONG Base
,
10245 _Inout_ PUNICODE_STRING String
);
10248 #define RtlIntPtrToUnicodeString(Value, Base, String) \
10249 RtlInt64ToUnicodeString(Value, Base, String)
10251 #define RtlIntPtrToUnicodeString(Value, Base, String) \
10252 RtlIntegerToUnicodeString(Value, Base, String)
10259 #define RtlIsZeroLuid(_L1) \
10260 ((BOOLEAN) ((!(_L1)->LowPart) && (!(_L1)->HighPart)))
10262 _IRQL_requires_max_(APC_LEVEL
)
10266 RtlLengthSecurityDescriptor(
10267 _In_ PSECURITY_DESCRIPTOR SecurityDescriptor
);
10272 RtlNumberOfClearBits(
10273 _In_ PRTL_BITMAP BitMapHeader
);
10278 RtlNumberOfSetBits(
10279 _In_ PRTL_BITMAP BitMapHeader
);
10281 _IRQL_requires_max_(PASSIVE_LEVEL
)
10285 RtlQueryRegistryValues(
10286 _In_ ULONG RelativeTo
,
10288 _Inout_
_At_(*(*QueryTable
).EntryContext
, _Pre_unknown_
)
10289 PRTL_QUERY_REGISTRY_TABLE QueryTable
,
10290 _In_opt_ PVOID Context
,
10291 _In_opt_ PVOID Environment
);
10293 #define SHORT_SIZE (sizeof(USHORT))
10294 #define SHORT_MASK (SHORT_SIZE - 1)
10295 #define LONG_SIZE (sizeof(LONG))
10296 #define LONGLONG_SIZE (sizeof(LONGLONG))
10297 #define LONG_MASK (LONG_SIZE - 1)
10298 #define LONGLONG_MASK (LONGLONG_SIZE - 1)
10299 #define LOWBYTE_MASK 0x00FF
10301 #define FIRSTBYTE(VALUE) ((VALUE) & LOWBYTE_MASK)
10302 #define SECONDBYTE(VALUE) (((VALUE) >> 8) & LOWBYTE_MASK)
10303 #define THIRDBYTE(VALUE) (((VALUE) >> 16) & LOWBYTE_MASK)
10304 #define FOURTHBYTE(VALUE) (((VALUE) >> 24) & LOWBYTE_MASK)
10310 _In_ PRTL_BITMAP BitMapHeader
);
10316 _In_ PRTL_BITMAP BitMapHeader
,
10317 _In_range_(0, BitMapHeader
->SizeOfBitMap
- NumberToSet
) ULONG StartingIndex
,
10318 _In_range_(0, BitMapHeader
->SizeOfBitMap
- StartingIndex
) ULONG NumberToSet
);
10320 _IRQL_requires_max_(APC_LEVEL
)
10324 RtlSetDaclSecurityDescriptor(
10325 _Inout_ PSECURITY_DESCRIPTOR SecurityDescriptor
,
10326 _In_ BOOLEAN DaclPresent
,
10327 _In_opt_ PACL Dacl
,
10328 _In_opt_ BOOLEAN DaclDefaulted
);
10330 #if defined(_AMD64_)
10334 * IN PULONG Address,
10337 #define RtlStoreUlong(Address,Value) \
10338 *(ULONG UNALIGNED *)(Address) = (Value)
10341 * RtlStoreUlonglong(
10342 * IN OUT PULONGLONG Address,
10343 * ULONGLONG Value);
10345 #define RtlStoreUlonglong(Address,Value) \
10346 *(ULONGLONG UNALIGNED *)(Address) = (Value)
10350 * IN PUSHORT Address,
10351 * IN USHORT Value);
10353 #define RtlStoreUshort(Address,Value) \
10354 *(USHORT UNALIGNED *)(Address) = (Value)
10357 * RtlRetrieveUshort(
10358 * PUSHORT DestinationAddress,
10359 * PUSHORT SourceAddress);
10361 #define RtlRetrieveUshort(DestAddress,SrcAddress) \
10362 *(USHORT UNALIGNED *)(DestAddress) = *(USHORT)(SrcAddress)
10365 * RtlRetrieveUlong(
10366 * PULONG DestinationAddress,
10367 * PULONG SourceAddress);
10369 #define RtlRetrieveUlong(DestAddress,SrcAddress) \
10370 *(ULONG UNALIGNED *)(DestAddress) = *(PULONG)(SrcAddress)
10374 #define RtlStoreUlong(Address,Value) \
10375 if ((ULONG_PTR)(Address) & LONG_MASK) { \
10376 ((PUCHAR) (Address))[LONG_LEAST_SIGNIFICANT_BIT] = (UCHAR)(FIRSTBYTE(Value)); \
10377 ((PUCHAR) (Address))[LONG_3RD_MOST_SIGNIFICANT_BIT] = (UCHAR)(SECONDBYTE(Value)); \
10378 ((PUCHAR) (Address))[LONG_2ND_MOST_SIGNIFICANT_BIT] = (UCHAR)(THIRDBYTE(Value)); \
10379 ((PUCHAR) (Address))[LONG_MOST_SIGNIFICANT_BIT] = (UCHAR)(FOURTHBYTE(Value)); \
10382 *((PULONG)(Address)) = (ULONG) (Value); \
10385 #define RtlStoreUlonglong(Address,Value) \
10386 if ((ULONG_PTR)(Address) & LONGLONG_MASK) { \
10387 RtlStoreUlong((ULONG_PTR)(Address), \
10388 (ULONGLONG)(Value) & 0xFFFFFFFF); \
10389 RtlStoreUlong((ULONG_PTR)(Address)+sizeof(ULONG), \
10390 (ULONGLONG)(Value) >> 32); \
10392 *((PULONGLONG)(Address)) = (ULONGLONG)(Value); \
10395 #define RtlStoreUshort(Address,Value) \
10396 if ((ULONG_PTR)(Address) & SHORT_MASK) { \
10397 ((PUCHAR) (Address))[SHORT_LEAST_SIGNIFICANT_BIT] = (UCHAR)(FIRSTBYTE(Value)); \
10398 ((PUCHAR) (Address))[SHORT_MOST_SIGNIFICANT_BIT ] = (UCHAR)(SECONDBYTE(Value)); \
10401 *((PUSHORT) (Address)) = (USHORT)Value; \
10404 #define RtlRetrieveUshort(DestAddress,SrcAddress) \
10405 if ((ULONG_PTR)(SrcAddress) & LONG_MASK) \
10407 ((PUCHAR)(DestAddress))[0]=((PUCHAR)(SrcAddress))[0]; \
10408 ((PUCHAR)(DestAddress))[1]=((PUCHAR)(SrcAddress))[1]; \
10412 *((PUSHORT)(DestAddress))=*((PUSHORT)(SrcAddress)); \
10415 #define RtlRetrieveUlong(DestAddress,SrcAddress) \
10416 if ((ULONG_PTR)(SrcAddress) & LONG_MASK) \
10418 ((PUCHAR)(DestAddress))[0]=((PUCHAR)(SrcAddress))[0]; \
10419 ((PUCHAR)(DestAddress))[1]=((PUCHAR)(SrcAddress))[1]; \
10420 ((PUCHAR)(DestAddress))[2]=((PUCHAR)(SrcAddress))[2]; \
10421 ((PUCHAR)(DestAddress))[3]=((PUCHAR)(SrcAddress))[3]; \
10425 *((PULONG)(DestAddress))=*((PULONG)(SrcAddress)); \
10428 #endif /* defined(_AMD64_) */
10432 * RtlStoreUlongPtr(
10433 * IN OUT PULONG_PTR Address,
10434 * IN ULONG_PTR Value);
10436 #define RtlStoreUlongPtr(Address,Value) RtlStoreUlonglong(Address,Value)
10438 #define RtlStoreUlongPtr(Address,Value) RtlStoreUlong(Address,Value)
10439 #endif /* _WIN64 */
10441 _Success_(return!=FALSE
)
10442 _Must_inspect_result_
10446 RtlTimeFieldsToTime(
10447 _In_ PTIME_FIELDS TimeFields
,
10448 _Out_ PLARGE_INTEGER Time
);
10453 RtlTimeToTimeFields(
10454 _In_ PLARGE_INTEGER Time
,
10455 _Out_ PTIME_FIELDS TimeFields
);
10461 _In_ ULONG Source
);
10466 RtlUlonglongByteSwap(
10467 _In_ ULONGLONG Source
);
10469 _When_(AllocateDestinationString
,
10470 _At_(DestinationString
->MaximumLength
,
10471 _Out_range_(<=, (SourceString
->MaximumLength
/ sizeof(WCHAR
)))))
10472 _When_(!AllocateDestinationString
,
10473 _At_(DestinationString
->Buffer
, _Const_
)
10474 _At_(DestinationString
->MaximumLength
, _Const_
))
10475 _IRQL_requires_max_(PASSIVE_LEVEL
)
10476 _When_(AllocateDestinationString
, _Must_inspect_result_
)
10480 RtlUnicodeStringToAnsiString(
10481 _When_(AllocateDestinationString
, _Out_
_At_(DestinationString
->Buffer
, __drv_allocatesMem(Mem
)))
10482 _When_(!AllocateDestinationString
, _Inout_
)
10483 PANSI_STRING DestinationString
,
10484 _In_ PCUNICODE_STRING SourceString
,
10485 _In_ BOOLEAN AllocateDestinationString
);
10487 _IRQL_requires_max_(PASSIVE_LEVEL
)
10491 RtlxUnicodeStringToAnsiSize(
10492 _In_ PCUNICODE_STRING UnicodeString
);
10494 #define RtlUnicodeStringToAnsiSize(String) ( \
10495 NLS_MB_CODE_PAGE_TAG ? \
10496 RtlxUnicodeStringToAnsiSize(String) : \
10497 ((String)->Length + sizeof(UNICODE_NULL)) / sizeof(WCHAR) \
10500 _IRQL_requires_max_(PASSIVE_LEVEL
)
10504 RtlUnicodeStringToInteger(
10505 _In_ PCUNICODE_STRING String
,
10506 _In_opt_ ULONG Base
,
10507 _Out_ PULONG Value
);
10509 _IRQL_requires_max_(PASSIVE_LEVEL
)
10513 RtlUpcaseUnicodeChar(
10514 _In_ WCHAR SourceCharacter
);
10520 _In_ USHORT Source
);
10522 _IRQL_requires_max_(APC_LEVEL
)
10523 _Must_inspect_result_
10527 RtlValidRelativeSecurityDescriptor(
10528 _In_reads_bytes_(SecurityDescriptorLength
) PSECURITY_DESCRIPTOR SecurityDescriptorInput
,
10529 _In_ ULONG SecurityDescriptorLength
,
10530 _In_ SECURITY_INFORMATION RequiredInformation
);
10532 _IRQL_requires_max_(APC_LEVEL
)
10533 _Must_inspect_result_
10537 RtlValidSecurityDescriptor(
10538 _In_ PSECURITY_DESCRIPTOR SecurityDescriptor
);
10540 _IRQL_requires_max_(PASSIVE_LEVEL
)
10546 _At_(lpVersionInformation
->dwOSVersionInfoSize
, _Pre_ _Valid_
)
10547 _When_(lpVersionInformation
->dwOSVersionInfoSize
== sizeof(RTL_OSVERSIONINFOEXW
),
10548 _At_((PRTL_OSVERSIONINFOEXW
)lpVersionInformation
, _Out_
))
10549 PRTL_OSVERSIONINFOW lpVersionInformation
);
10551 _IRQL_requires_max_(PASSIVE_LEVEL
)
10552 _Must_inspect_result_
10556 RtlVerifyVersionInfo(
10557 _In_ PRTL_OSVERSIONINFOEXW VersionInfo
,
10558 _In_ ULONG TypeMask
,
10559 _In_ ULONGLONG ConditionMask
);
10561 _IRQL_requires_max_(PASSIVE_LEVEL
)
10565 RtlWriteRegistryValue(
10566 _In_ ULONG RelativeTo
,
10568 _In_z_ PCWSTR ValueName
,
10569 _In_ ULONG ValueType
,
10570 _In_reads_bytes_opt_(ValueLength
) PVOID ValueData
,
10571 _In_ ULONG ValueLength
);
10574 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
10577 #if (NTDDI_VERSION >= NTDDI_WIN2KSP3)
10581 RtlPrefetchMemoryNonTemporal(
10583 _In_ SIZE_T Length
);
10587 #if (NTDDI_VERSION >= NTDDI_WINXP)
10594 _In_ PRTL_BITMAP BitMapHeader
,
10595 _In_range_(<, BitMapHeader
->SizeOfBitMap
) ULONG BitNumber
);
10597 _IRQL_requires_max_(PASSIVE_LEVEL
)
10601 RtlDowncaseUnicodeChar(
10602 _In_ WCHAR SourceCharacter
);
10608 _In_ PRTL_BITMAP BitMapHeader
,
10609 _In_range_(<, BitMapHeader
->SizeOfBitMap
) ULONG BitNumber
);
10611 _Must_inspect_result_
10616 _In_ PRTL_BITMAP BitMapHeader
,
10617 _In_range_(<, BitMapHeader
->SizeOfBitMap
) ULONG BitNumber
);
10619 _IRQL_requires_max_(PASSIVE_LEVEL
)
10623 RtlHashUnicodeString(
10624 _In_ CONST UNICODE_STRING
*String
,
10625 _In_ BOOLEAN CaseInSensitive
,
10626 _In_ ULONG HashAlgorithm
,
10627 _Out_ PULONG HashValue
);
10631 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) */
10634 #if (NTDDI_VERSION >= NTDDI_VISTA)
10639 RtlNumberOfSetBitsUlongPtr(
10640 _In_ ULONG_PTR Target
);
10645 RtlIoDecodeMemIoResource(
10646 _In_
struct _IO_RESOURCE_DESCRIPTOR
*Descriptor
,
10647 _Out_opt_ PULONGLONG Alignment
,
10648 _Out_opt_ PULONGLONG MinimumAddress
,
10649 _Out_opt_ PULONGLONG MaximumAddress
);
10654 RtlIoEncodeMemIoResource(
10655 _In_
struct _IO_RESOURCE_DESCRIPTOR
*Descriptor
,
10657 _In_ ULONGLONG Length
,
10658 _In_ ULONGLONG Alignment
,
10659 _In_ ULONGLONG MinimumAddress
,
10660 _In_ ULONGLONG MaximumAddress
);
10665 RtlCmDecodeMemIoResource(
10666 _In_
struct _CM_PARTIAL_RESOURCE_DESCRIPTOR
*Descriptor
,
10667 _Out_opt_ PULONGLONG Start
);
10672 RtlFindClosestEncodableLength(
10673 _In_ ULONGLONG SourceLength
,
10674 _Out_ PULONGLONG TargetLength
);
10679 RtlCmEncodeMemIoResource(
10680 _In_ PCM_PARTIAL_RESOURCE_DESCRIPTOR Descriptor
,
10682 _In_ ULONGLONG Length
,
10683 _In_ ULONGLONG Start
);
10686 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
10688 #if (NTDDI_VERSION >= NTDDI_WIN7)
10690 _IRQL_requires_max_(PASSIVE_LEVEL
)
10691 _Must_inspect_result_
10696 _Out_writes_bytes_to_(UTF8StringMaxByteCount
, *UTF8StringActualByteCount
)
10697 PCHAR UTF8StringDestination
,
10698 _In_ ULONG UTF8StringMaxByteCount
,
10699 _Out_ PULONG UTF8StringActualByteCount
,
10700 _In_reads_bytes_(UnicodeStringByteCount
) PCWCH UnicodeStringSource
,
10701 _In_ ULONG UnicodeStringByteCount
);
10703 _IRQL_requires_max_(PASSIVE_LEVEL
)
10704 _Must_inspect_result_
10709 _Out_writes_bytes_to_(UnicodeStringMaxByteCount
, *UnicodeStringActualByteCount
)
10710 PWSTR UnicodeStringDestination
,
10711 _In_ ULONG UnicodeStringMaxByteCount
,
10712 _Out_ PULONG UnicodeStringActualByteCount
,
10713 _In_reads_bytes_(UTF8StringByteCount
) PCCH UTF8StringSource
,
10714 _In_ ULONG UTF8StringByteCount
);
10719 RtlGetEnabledExtendedFeatures(
10720 IN ULONG64 FeatureMask
);
10723 #endif /* (NTDDI_VERSION >= NTDDI_WIN7) */
10726 #if !defined(MIDL_PASS)
10727 /* inline funftions */
10728 //DECLSPEC_DEPRECATED_DDK_WINXP
10732 RtlConvertLongToLargeInteger(
10733 _In_ LONG SignedInteger
)
10736 ret
.QuadPart
= SignedInteger
;
10740 //DECLSPEC_DEPRECATED_DDK_WINXP
10744 RtlConvertUlongToLargeInteger(
10745 _In_ ULONG UnsignedInteger
)
10748 ret
.QuadPart
= UnsignedInteger
;
10752 //DECLSPEC_DEPRECATED_DDK_WINXP
10756 RtlLargeIntegerShiftLeft(
10757 _In_ LARGE_INTEGER LargeInteger
,
10758 _In_ CCHAR ShiftCount
)
10760 LARGE_INTEGER Result
;
10762 Result
.QuadPart
= LargeInteger
.QuadPart
<< ShiftCount
;
10766 //DECLSPEC_DEPRECATED_DDK_WINXP
10770 RtlLargeIntegerShiftRight(
10771 _In_ LARGE_INTEGER LargeInteger
,
10772 _In_ CCHAR ShiftCount
)
10774 LARGE_INTEGER Result
;
10776 Result
.QuadPart
= (ULONG64
)LargeInteger
.QuadPart
>> ShiftCount
;
10780 //DECLSPEC_DEPRECATED_DDK
10784 RtlEnlargedUnsignedDivide(
10785 _In_ ULARGE_INTEGER Dividend
,
10786 _In_ ULONG Divisor
,
10787 _Out_opt_ PULONG Remainder
)
10790 *Remainder
= (ULONG
)(Dividend
.QuadPart
% Divisor
);
10791 return (ULONG
)(Dividend
.QuadPart
/ Divisor
);
10794 //DECLSPEC_DEPRECATED_DDK
10798 RtlLargeIntegerNegate(
10799 _In_ LARGE_INTEGER Subtrahend
)
10801 LARGE_INTEGER Difference
;
10803 Difference
.QuadPart
= -Subtrahend
.QuadPart
;
10807 //DECLSPEC_DEPRECATED_DDK
10811 RtlLargeIntegerSubtract(
10812 _In_ LARGE_INTEGER Minuend
,
10813 _In_ LARGE_INTEGER Subtrahend
)
10815 LARGE_INTEGER Difference
;
10817 Difference
.QuadPart
= Minuend
.QuadPart
- Subtrahend
.QuadPart
;
10821 //DECLSPEC_DEPRECATED_DDK
10825 RtlEnlargedUnsignedMultiply(
10826 _In_ ULONG Multiplicand
,
10827 _In_ ULONG Multiplier
)
10830 ret
.QuadPart
= (ULONGLONG
)Multiplicand
* (ULONGLONG
)Multiplier
;
10834 //DECLSPEC_DEPRECATED_DDK
10838 RtlEnlargedIntegerMultiply(
10839 _In_ LONG Multiplicand
,
10840 _In_ LONG Multiplier
)
10843 ret
.QuadPart
= (LONGLONG
)Multiplicand
* (ULONGLONG
)Multiplier
;
10847 _At_(AnsiString
->Buffer
, _Post_equal_to_(Buffer
))
10848 _At_(AnsiString
->Length
, _Post_equal_to_(0))
10849 _At_(AnsiString
->MaximumLength
, _Post_equal_to_(BufferSize
))
10852 RtlInitEmptyAnsiString(
10853 _Out_ PANSI_STRING AnsiString
,
10854 _Pre_maybenull_
_Pre_readable_size_(BufferSize
) __drv_aliasesMem PCHAR Buffer
,
10855 _In_ USHORT BufferSize
)
10857 AnsiString
->Length
= 0;
10858 AnsiString
->MaximumLength
= BufferSize
;
10859 AnsiString
->Buffer
= Buffer
;
10862 _At_(UnicodeString
->Buffer
, _Post_equal_to_(Buffer
))
10863 _At_(UnicodeString
->Length
, _Post_equal_to_(0))
10864 _At_(UnicodeString
->MaximumLength
, _Post_equal_to_(BufferSize
))
10867 RtlInitEmptyUnicodeString(
10868 _Out_ PUNICODE_STRING UnicodeString
,
10869 _Writable_bytes_(BufferSize
)
10870 _When_(BufferSize
!= 0, _Notnull_
)
10871 __drv_aliasesMem PWSTR Buffer
,
10872 _In_ USHORT BufferSize
)
10874 UnicodeString
->Length
= 0;
10875 UnicodeString
->MaximumLength
= BufferSize
;
10876 UnicodeString
->Buffer
= Buffer
;
10879 #if defined(_AMD64_) || defined(_IA64_)
10885 RtlExtendedIntegerMultiply(
10886 _In_ LARGE_INTEGER Multiplicand
,
10887 _In_ LONG Multiplier
)
10890 ret
.QuadPart
= Multiplicand
.QuadPart
* Multiplier
;
10897 RtlExtendedLargeIntegerDivide(
10898 _In_ LARGE_INTEGER Dividend
,
10899 _In_ ULONG Divisor
,
10900 _Out_opt_ PULONG Remainder
)
10903 ret
.QuadPart
= (ULONG64
)Dividend
.QuadPart
/ Divisor
;
10905 *Remainder
= (ULONG
)(Dividend
.QuadPart
% Divisor
);
10911 #endif /* defined(_AMD64_) || defined(_IA64_) */
10914 #if defined(_AMD64_)
10916 #define MultiplyHigh __mulh
10917 #define UnsignedMultiplyHigh __umulh
10919 //DECLSPEC_DEPRECATED_DDK
10923 RtlExtendedMagicDivide(
10924 _In_ LARGE_INTEGER Dividend
,
10925 _In_ LARGE_INTEGER MagicDivisor
,
10926 _In_ CCHAR ShiftCount
)
10931 Pos
= (Dividend
.QuadPart
>= 0);
10932 ret64
= UnsignedMultiplyHigh(Pos
? Dividend
.QuadPart
: -Dividend
.QuadPart
,
10933 MagicDivisor
.QuadPart
);
10934 ret64
>>= ShiftCount
;
10935 ret
.QuadPart
= Pos
? ret64
: -(LONG64
)ret64
;
10940 //DECLSPEC_DEPRECATED_DDK
10944 RtlLargeIntegerAdd(
10945 _In_ LARGE_INTEGER Addend1
,
10946 _In_ LARGE_INTEGER Addend2
)
10949 ret
.QuadPart
= Addend1
.QuadPart
+ Addend2
.QuadPart
;
10954 * RtlLargeIntegerAnd(
10955 * IN OUT LARGE_INTEGER Result,
10956 * IN LARGE_INTEGER Source,
10957 * IN LARGE_INTEGER Mask);
10959 #define RtlLargeIntegerAnd(Result, Source, Mask) \
10960 Result.QuadPart = Source.QuadPart & Mask.QuadPart
10962 //DECLSPEC_DEPRECATED_DDK
10966 RtlLargeIntegerArithmeticShift(
10967 _In_ LARGE_INTEGER LargeInteger
,
10968 _In_ CCHAR ShiftCount
)
10971 ret
.QuadPart
= LargeInteger
.QuadPart
>> ShiftCount
;
10976 * RtlLargeIntegerEqualTo(
10977 * IN LARGE_INTEGER Operand1,
10978 * IN LARGE_INTEGER Operand2);
10980 #define RtlLargeIntegerEqualTo(X,Y) \
10981 (!(((X).LowPart ^ (Y).LowPart) | ((X).HighPart ^ (Y).HighPart)))
10985 RtlSecureZeroMemory(
10986 _Out_writes_bytes_all_(Size
) PVOID Pointer
,
10989 volatile char* vptr
= (volatile char*)Pointer
;
10990 #if defined(_M_AMD64)
10991 __stosb((PUCHAR
)vptr
, 0, Size
);
10993 char * endptr
= (char *)vptr
+ Size
;
10994 while (vptr
< endptr
) {
11001 #if defined(_M_AMD64)
11002 _Must_inspect_result_
11006 _In_ PRTL_BITMAP BitMapHeader
,
11007 _In_range_(<, BitMapHeader
->SizeOfBitMap
) ULONG BitPosition
)
11009 return BitTest64((LONG64 CONST
*)BitMapHeader
->Buffer
, (LONG64
)BitPosition
);
11012 #define RtlCheckBit(BMH,BP) (((((PLONG)(BMH)->Buffer)[(BP)/32]) >> ((BP)%32)) & 0x1)
11013 #endif /* defined(_M_AMD64) */
11015 #define RtlLargeIntegerGreaterThan(X,Y) ( \
11016 (((X).HighPart == (Y).HighPart) && ((X).LowPart > (Y).LowPart)) || \
11017 ((X).HighPart > (Y).HighPart) \
11020 #define RtlLargeIntegerGreaterThanOrEqualTo(X,Y) ( \
11021 (((X).HighPart == (Y).HighPart) && ((X).LowPart >= (Y).LowPart)) || \
11022 ((X).HighPart > (Y).HighPart) \
11025 #define RtlLargeIntegerNotEqualTo(X,Y) ( \
11026 (((X).LowPart ^ (Y).LowPart) | ((X).HighPart ^ (Y).HighPart)) \
11029 #define RtlLargeIntegerLessThan(X,Y) ( \
11030 (((X).HighPart == (Y).HighPart) && ((X).LowPart < (Y).LowPart)) || \
11031 ((X).HighPart < (Y).HighPart) \
11034 #define RtlLargeIntegerLessThanOrEqualTo(X,Y) ( \
11035 (((X).HighPart == (Y).HighPart) && ((X).LowPart <= (Y).LowPart)) || \
11036 ((X).HighPart < (Y).HighPart) \
11039 #define RtlLargeIntegerGreaterThanZero(X) ( \
11040 (((X).HighPart == 0) && ((X).LowPart > 0)) || \
11041 ((X).HighPart > 0 ) \
11044 #define RtlLargeIntegerGreaterOrEqualToZero(X) ( (X).HighPart >= 0 )
11046 #define RtlLargeIntegerEqualToZero(X) ( !((X).LowPart | (X).HighPart) )
11048 #define RtlLargeIntegerNotEqualToZero(X) ( ((X).LowPart | (X).HighPart) )
11050 #define RtlLargeIntegerLessThanZero(X) ( ((X).HighPart < 0) )
11052 #define RtlLargeIntegerLessOrEqualToZero(X) ( ((X).HighPart < 0) || !((X).LowPart | (X).HighPart) )
11054 #endif /* !defined(MIDL_PASS) */
11056 /* Byte Swap Functions */
11057 #if (defined(_M_IX86) && (_MSC_FULL_VER > 13009037 || defined(__GNUC__))) || \
11058 ((defined(_M_AMD64) || defined(_M_IA64)) \
11059 && (_MSC_FULL_VER > 13009175 || defined(__GNUC__)))
11061 #define RtlUshortByteSwap(_x) _byteswap_ushort((USHORT)(_x))
11062 #define RtlUlongByteSwap(_x) _byteswap_ulong((_x))
11063 #define RtlUlonglongByteSwap(_x) _byteswap_uint64((_x))
11069 #define RTL_VERIFY(exp) \
11071 RtlAssert( (PVOID)#exp, (PVOID)__FILE__, __LINE__, NULL ), FALSE : TRUE)
11073 #define RTL_VERIFYMSG(msg, exp) \
11075 RtlAssert( (PVOID)#exp, (PVOID)__FILE__, __LINE__, (PCHAR)msg ), FALSE : TRUE)
11077 #define RTL_SOFT_VERIFY(exp) \
11079 DbgPrint("%s(%d): Soft assertion failed\n Expression: %s\n", __FILE__, __LINE__, #exp), FALSE : TRUE)
11081 #define RTL_SOFT_VERIFYMSG(msg, exp) \
11083 DbgPrint("%s(%d): Soft assertion failed\n Expression: %s\n Message: %s\n", __FILE__, __LINE__, #exp, (msg)), FALSE : TRUE)
11085 /* The ASSERTs must be cast to void to avoid warnings about unused results.
11086 * We also cannot invoke the VERIFY versions because the indirection messes
11087 * with stringify. */
11088 #define ASSERT(exp) \
11089 ((VOID)((!(exp)) ? \
11090 RtlAssert( (PVOID)#exp, (PVOID)__FILE__, __LINE__, NULL ), FALSE : TRUE))
11092 #define ASSERTMSG(msg, exp) \
11093 ((VOID)((!(exp)) ? \
11094 RtlAssert( (PVOID)#exp, (PVOID)__FILE__, __LINE__, (PCHAR)msg ), FALSE : TRUE))
11096 #define RTL_SOFT_ASSERT(exp) \
11097 ((VOID)((!(exp)) ? \
11098 DbgPrint("%s(%d): Soft assertion failed\n Expression: %s\n", __FILE__, __LINE__, #exp), FALSE : TRUE))
11100 #define RTL_SOFT_ASSERTMSG(msg, exp) \
11101 ((VOID)((!(exp)) ? \
11102 DbgPrint("%s(%d): Soft assertion failed\n Expression: %s\n Message: %s\n", __FILE__, __LINE__, #exp, (msg)), FALSE : TRUE))
11104 #if defined(_MSC_VER)
11105 # define __assert_annotationA(msg) __annotation(L"Debug", L"AssertFail", L ## msg)
11106 # define __assert_annotationW(msg) __annotation(L"Debug", L"AssertFail", msg)
11108 # define __assert_annotationA(msg) \
11109 DbgPrint("Assertion %s(%d): %s", __FILE__, __LINE__, msg)
11110 # define __assert_annotationW(msg) \
11111 DbgPrint("Assertion %s(%d): %S", __FILE__, __LINE__, msg)
11114 #define NT_VERIFY(exp) \
11116 (__assert_annotationA(#exp), \
11117 DbgRaiseAssertionFailure(), FALSE) : TRUE)
11119 #define NT_VERIFYMSG(msg, exp) \
11121 (__assert_annotationA(msg), \
11122 DbgRaiseAssertionFailure(), FALSE) : TRUE)
11124 #define NT_VERIFYMSGW(msg, exp) \
11126 (__assert_annotationW(msg), \
11127 DbgRaiseAssertionFailure(), FALSE) : TRUE)
11129 /* Can't reuse verify, see above */
11130 #define NT_ASSERT(exp) \
11131 ((VOID)((!(exp)) ? \
11132 (__assert_annotationA(#exp), \
11133 DbgRaiseAssertionFailure(), FALSE) : TRUE))
11135 #define NT_ASSERTMSG(msg, exp) \
11136 ((VOID)((!(exp)) ? \
11137 (__assert_annotationA(msg), \
11138 DbgRaiseAssertionFailure(), FALSE) : TRUE))
11140 #define NT_ASSERTMSGW(msg, exp) \
11141 ((VOID)((!(exp)) ? \
11142 (__assert_annotationW(msg), \
11143 DbgRaiseAssertionFailure(), FALSE) : TRUE))
11147 #define ASSERT(exp) ((VOID) 0)
11148 #define ASSERTMSG(msg, exp) ((VOID) 0)
11150 #define RTL_SOFT_ASSERT(exp) ((VOID) 0)
11151 #define RTL_SOFT_ASSERTMSG(msg, exp) ((VOID) 0)
11153 #define RTL_VERIFY(exp) ((exp) ? TRUE : FALSE)
11154 #define RTL_VERIFYMSG(msg, exp) ((exp) ? TRUE : FALSE)
11156 #define RTL_SOFT_VERIFY(exp) ((exp) ? TRUE : FALSE)
11157 #define RTL_SOFT_VERIFYMSG(msg, exp) ((exp) ? TRUE : FALSE)
11159 #define NT_ASSERT(exp) ((VOID)0)
11160 #define NT_ASSERTMSG(msg, exp) ((VOID)0)
11161 #define NT_ASSERTMSGW(msg, exp) ((VOID)0)
11163 #define NT_VERIFY(_exp) ((_exp) ? TRUE : FALSE)
11164 #define NT_VERIFYMSG(_msg, _exp ) ((_exp) ? TRUE : FALSE)
11165 #define NT_VERIFYMSGW(_msg, _exp) ((_exp) ? TRUE : FALSE)
11169 #define InitializeListHead32(ListHead) (\
11170 (ListHead)->Flink = (ListHead)->Blink = PtrToUlong((ListHead)))
11172 #if !defined(_WINBASE_)
11174 #if defined(_WIN64) && (defined(_NTDRIVER_) || defined(_NTDDK_) || defined(_NTIFS_) || defined(_NTHAL_) || defined(_NTOSP_))
11178 InitializeSListHead(
11179 _Out_ PSLIST_HEADER SListHead
);
11185 InitializeSListHead(
11186 _Out_ PSLIST_HEADER SListHead
)
11188 #if defined(_IA64_)
11189 ULONG64 FeatureBits
;
11192 #if defined(_WIN64)
11193 if (((ULONG_PTR
)SListHead
& 0xf) != 0) {
11194 RtlRaiseStatus(STATUS_DATATYPE_MISALIGNMENT
);
11197 RtlZeroMemory(SListHead
, sizeof(SLIST_HEADER
));
11198 #if defined(_IA64_)
11199 FeatureBits
= __getReg(CV_IA64_CPUID4
);
11200 if ((FeatureBits
& KF_16BYTE_INSTR
) != 0) {
11201 SListHead
->Header16
.HeaderType
= 1;
11202 SListHead
->Header16
.Init
= 1;
11209 #if defined(_WIN64)
11211 #define InterlockedPopEntrySList(Head) \
11212 ExpInterlockedPopEntrySList(Head)
11214 #define InterlockedPushEntrySList(Head, Entry) \
11215 ExpInterlockedPushEntrySList(Head, Entry)
11217 #define InterlockedFlushSList(Head) \
11218 ExpInterlockedFlushSList(Head)
11220 #define QueryDepthSList(Head) \
11221 ExQueryDepthSList(Head)
11223 #else /* !defined(_WIN64) */
11228 InterlockedPopEntrySList(
11229 _Inout_ PSLIST_HEADER ListHead
);
11234 InterlockedPushEntrySList(
11235 _Inout_ PSLIST_HEADER ListHead
,
11236 _Inout_ __drv_aliasesMem PSLIST_ENTRY ListEntry
);
11238 #define InterlockedFlushSList(ListHead) \
11239 ExInterlockedFlushSList(ListHead)
11241 #define QueryDepthSList(Head) \
11242 ExQueryDepthSList(Head)
11244 #endif /* !defined(_WIN64) */
11246 #endif /* !defined(_WINBASE_) */
11248 #define RTL_CONTEXT_EX_OFFSET(ContextEx, Chunk) ((ContextEx)->Chunk.Offset)
11249 #define RTL_CONTEXT_EX_LENGTH(ContextEx, Chunk) ((ContextEx)->Chunk.Length)
11250 #define RTL_CONTEXT_EX_CHUNK(Base, Layout, Chunk) \
11251 ((PVOID)((PCHAR)(Base) + RTL_CONTEXT_EX_OFFSET(Layout, Chunk)))
11252 #define RTL_CONTEXT_OFFSET(Context, Chunk) \
11253 RTL_CONTEXT_EX_OFFSET((PCONTEXT_EX)(Context + 1), Chunk)
11254 #define RTL_CONTEXT_LENGTH(Context, Chunk) \
11255 RTL_CONTEXT_EX_LENGTH((PCONTEXT_EX)(Context + 1), Chunk)
11256 #define RTL_CONTEXT_CHUNK(Context, Chunk) \
11257 RTL_CONTEXT_EX_CHUNK((PCONTEXT_EX)(Context + 1), \
11258 (PCONTEXT_EX)(Context + 1), \
11262 RTLVERLIB_DDI(RtlIsNtDdiVersionAvailable
)(
11263 _In_ ULONG Version
);
11266 RTLVERLIB_DDI(RtlIsServicePackVersionInstalled
)(
11267 _In_ ULONG Version
);
11269 #ifndef RtlIsNtDdiVersionAvailable
11270 #define RtlIsNtDdiVersionAvailable WdmlibRtlIsNtDdiVersionAvailable
11273 #ifndef RtlIsServicePackVersionInstalled
11274 #define RtlIsServicePackVersionInstalled WdmlibRtlIsServicePackVersionInstalled
11277 #define RtlInterlockedSetBits(Flags, Flag) \
11278 InterlockedOr((PLONG)(Flags), Flag)
11280 #define RtlInterlockedAndBits(Flags, Flag) \
11281 InterlockedAnd((PLONG)(Flags), Flag)
11283 #define RtlInterlockedClearBits(Flags, Flag) \
11284 RtlInterlockedAndBits(Flags, ~(Flag))
11286 #define RtlInterlockedXorBits(Flags, Flag) \
11287 InterlockedXor(Flags, Flag)
11289 #define RtlInterlockedSetBitsDiscardReturn(Flags, Flag) \
11290 (VOID) RtlInterlockedSetBits(Flags, Flag)
11292 #define RtlInterlockedAndBitsDiscardReturn(Flags, Flag) \
11293 (VOID) RtlInterlockedAndBits(Flags, Flag)
11295 #define RtlInterlockedClearBitsDiscardReturn(Flags, Flag) \
11296 RtlInterlockedAndBitsDiscardReturn(Flags, ~(Flag))
11299 /******************************************************************************
11300 * Memory manager Functions *
11301 ******************************************************************************/
11302 /* Alignment Macros */
11303 #define ALIGN_DOWN_BY(size, align) \
11304 ((ULONG_PTR)(size) & ~((ULONG_PTR)(align) - 1))
11306 #define ALIGN_UP_BY(size, align) \
11307 (ALIGN_DOWN_BY(((ULONG_PTR)(size) + align - 1), align))
11309 #define ALIGN_DOWN_POINTER_BY(ptr, align) \
11310 ((PVOID)ALIGN_DOWN_BY(ptr, align))
11312 #define ALIGN_UP_POINTER_BY(ptr, align) \
11313 ((PVOID)ALIGN_UP_BY(ptr, align))
11315 #define ALIGN_DOWN(size, type) \
11316 ALIGN_DOWN_BY(size, sizeof(type))
11318 #define ALIGN_UP(size, type) \
11319 ALIGN_UP_BY(size, sizeof(type))
11321 #define ALIGN_DOWN_POINTER(ptr, type) \
11322 ALIGN_DOWN_POINTER_BY(ptr, sizeof(type))
11324 #define ALIGN_UP_POINTER(ptr, type) \
11325 ALIGN_UP_POINTER_BY(ptr, sizeof(type))
11327 #ifndef FIELD_OFFSET
11328 #define FIELD_OFFSET(type, field) ((ULONG)&(((type *)0)->field))
11332 #define FIELD_SIZE(type, field) (sizeof(((type *)0)->field))
11335 #define POOL_TAGGING 1
11338 #define IF_DEBUG if (TRUE)
11340 #define IF_DEBUG if (FALSE)
11347 #define BYTE_OFFSET(Va) \
11348 ((ULONG) ((ULONG_PTR) (Va) & (PAGE_SIZE - 1)))
11354 * Note: This needs to be like this to avoid overflows!
11356 #define BYTES_TO_PAGES(Size) \
11357 (((Size) >> PAGE_SHIFT) + (((Size) & (PAGE_SIZE - 1)) != 0))
11363 #define PAGE_ALIGN(Va) \
11364 ((PVOID) ((ULONG_PTR)(Va) & ~(PAGE_SIZE - 1)))
11368 * _In_ ULONG_PTR Size)
11370 #define ROUND_TO_PAGES(Size) \
11371 (((ULONG_PTR) (Size) + PAGE_SIZE - 1) & ~(PAGE_SIZE - 1))
11374 * ADDRESS_AND_SIZE_TO_SPAN_PAGES(
11378 #define ADDRESS_AND_SIZE_TO_SPAN_PAGES(_Va, _Size) \
11379 ((ULONG) ((((ULONG_PTR) (_Va) & (PAGE_SIZE - 1)) \
11380 + (_Size) + (PAGE_SIZE - 1)) >> PAGE_SHIFT))
11382 #define COMPUTE_PAGES_SPANNED(Va, Size) \
11383 ADDRESS_AND_SIZE_TO_SPAN_PAGES(Va,Size)
11387 * MmGetMdlByteCount(
11390 #define MmGetMdlByteCount(_Mdl) \
11391 ((_Mdl)->ByteCount)
11395 * MmGetMdlByteOffset(
11398 #define MmGetMdlByteOffset(_Mdl) \
11399 ((_Mdl)->ByteOffset)
11401 #define MmGetMdlBaseVa(Mdl) ((Mdl)->StartVa)
11405 * MmGetMdlPfnArray(
11408 #define MmGetMdlPfnArray(_Mdl) \
11409 ((PPFN_NUMBER) ((_Mdl) + 1))
11413 * MmGetMdlVirtualAddress(
11416 #define MmGetMdlVirtualAddress(_Mdl) \
11417 ((PVOID) ((PCHAR) ((_Mdl)->StartVa) + (_Mdl)->ByteOffset))
11419 #define MmGetProcedureAddress(Address) (Address)
11420 #define MmLockPagableCodeSection(Address) MmLockPagableDataSection(Address)
11422 /* PVOID MmGetSystemAddressForMdl(
11425 #define MmGetSystemAddressForMdl(Mdl) \
11426 (((Mdl)->MdlFlags & (MDL_MAPPED_TO_SYSTEM_VA | \
11427 MDL_SOURCE_IS_NONPAGED_POOL)) ? \
11428 ((Mdl)->MappedSystemVa) : \
11429 (MmMapLockedPages((Mdl), KernelMode)))
11432 * MmGetSystemAddressForMdlSafe(
11434 * _In_ MM_PAGE_PRIORITY Priority)
11436 #define MmGetSystemAddressForMdlSafe(_Mdl, _Priority) \
11437 (((_Mdl)->MdlFlags & (MDL_MAPPED_TO_SYSTEM_VA \
11438 | MDL_SOURCE_IS_NONPAGED_POOL)) ? \
11439 (_Mdl)->MappedSystemVa : \
11440 (PVOID) MmMapLockedPagesSpecifyCache((_Mdl), \
11441 KernelMode, MmCached, NULL, FALSE, (_Priority)))
11446 * _In_ PMDL MemoryDescriptorList,
11447 * _In_ PVOID BaseVa,
11448 * _In_ SIZE_T Length)
11450 #define MmInitializeMdl(_MemoryDescriptorList, \
11454 (_MemoryDescriptorList)->Next = (PMDL) NULL; \
11455 (_MemoryDescriptorList)->Size = (CSHORT) (sizeof(MDL) + \
11456 (sizeof(PFN_NUMBER) * ADDRESS_AND_SIZE_TO_SPAN_PAGES(_BaseVa, _Length))); \
11457 (_MemoryDescriptorList)->MdlFlags = 0; \
11458 (_MemoryDescriptorList)->StartVa = (PVOID) PAGE_ALIGN(_BaseVa); \
11459 (_MemoryDescriptorList)->ByteOffset = BYTE_OFFSET(_BaseVa); \
11460 (_MemoryDescriptorList)->ByteCount = (ULONG) _Length; \
11465 * MmPrepareMdlForReuse(
11468 #define MmPrepareMdlForReuse(_Mdl) \
11470 if (((_Mdl)->MdlFlags & MDL_PARTIAL_HAS_BEEN_MAPPED) != 0) { \
11471 ASSERT(((_Mdl)->MdlFlags & MDL_PARTIAL) != 0); \
11472 MmUnmapLockedPages((_Mdl)->MappedSystemVa, (_Mdl)); \
11473 } else if (((_Mdl)->MdlFlags & MDL_PARTIAL) == 0) { \
11474 ASSERT(((_Mdl)->MdlFlags & MDL_MAPPED_TO_SYSTEM_VA) == 0); \
11478 #if (NTDDI_VERSION >= NTDDI_WIN2K)
11479 _Must_inspect_result_
11480 _IRQL_requires_max_(DISPATCH_LEVEL
)
11481 _When_ (return != NULL
, _Post_writable_byte_size_ (NumberOfBytes
))
11485 MmAllocateContiguousMemory(
11486 _In_ SIZE_T NumberOfBytes
,
11487 _In_ PHYSICAL_ADDRESS HighestAcceptableAddress
);
11489 _Must_inspect_result_
11490 _IRQL_requires_max_(DISPATCH_LEVEL
)
11491 _When_ (return != NULL
, _Post_writable_byte_size_ (NumberOfBytes
))
11495 MmAllocateContiguousMemorySpecifyCache(
11496 _In_ SIZE_T NumberOfBytes
,
11497 _In_ PHYSICAL_ADDRESS LowestAcceptableAddress
,
11498 _In_ PHYSICAL_ADDRESS HighestAcceptableAddress
,
11499 _In_opt_ PHYSICAL_ADDRESS BoundaryAddressMultiple
,
11500 _In_ MEMORY_CACHING_TYPE CacheType
);
11502 _Must_inspect_result_
11503 _IRQL_requires_max_(DISPATCH_LEVEL
)
11507 MmAllocatePagesForMdl(
11508 _In_ PHYSICAL_ADDRESS LowAddress
,
11509 _In_ PHYSICAL_ADDRESS HighAddress
,
11510 _In_ PHYSICAL_ADDRESS SkipBytes
,
11511 _In_ SIZE_T TotalBytes
);
11513 _IRQL_requires_max_(DISPATCH_LEVEL
)
11517 MmBuildMdlForNonPagedPool(
11518 _Inout_ PMDLX MemoryDescriptorList
);
11520 //DECLSPEC_DEPRECATED_DDK
11525 _Out_writes_bytes_opt_ (sizeof (MDL
) + (sizeof (PFN_NUMBER
) * ADDRESS_AND_SIZE_TO_SPAN_PAGES (Base
, Length
)))
11526 PMDL MemoryDescriptorList
,
11527 _In_reads_bytes_opt_ (Length
) PVOID Base
,
11528 _In_ SIZE_T Length
);
11530 _IRQL_requires_max_(DISPATCH_LEVEL
)
11534 MmFreeContiguousMemory(
11535 _In_ PVOID BaseAddress
);
11537 _IRQL_requires_max_ (DISPATCH_LEVEL
)
11541 MmFreeContiguousMemorySpecifyCache(
11542 _In_reads_bytes_ (NumberOfBytes
) PVOID BaseAddress
,
11543 _In_ SIZE_T NumberOfBytes
,
11544 _In_ MEMORY_CACHING_TYPE CacheType
);
11546 _IRQL_requires_max_(DISPATCH_LEVEL
)
11550 MmFreePagesFromMdl(
11551 _Inout_ PMDLX MemoryDescriptorList
);
11553 _IRQL_requires_max_(PASSIVE_LEVEL
)
11557 MmGetSystemRoutineAddress(
11558 _In_ PUNICODE_STRING SystemRoutineName
);
11563 MmIsDriverVerifying(
11564 _In_
struct _DRIVER_OBJECT
*DriverObject
);
11566 _Must_inspect_result_
11567 _IRQL_requires_max_(APC_LEVEL
)
11571 MmLockPagableDataSection(
11572 _In_ PVOID AddressWithinSection
);
11574 _Must_inspect_result_
11575 _IRQL_requires_max_(DISPATCH_LEVEL
)
11576 _Out_writes_bytes_opt_ (NumberOfBytes
)
11581 _In_ PHYSICAL_ADDRESS PhysicalAddress
,
11582 _In_ SIZE_T NumberOfBytes
,
11583 _In_ MEMORY_CACHING_TYPE CacheType
);
11585 _Must_inspect_result_
11586 _When_(AccessMode
==KernelMode
, _IRQL_requires_max_(DISPATCH_LEVEL
))
11587 _When_(AccessMode
==UserMode
, _Maybe_raises_SEH_exception_
_IRQL_requires_max_(APC_LEVEL
))
11592 _Inout_ PMDL MemoryDescriptorList
,
11593 _In_
__drv_strictType(KPROCESSOR_MODE
/enum _MODE
,__drv_typeConst
)
11594 KPROCESSOR_MODE AccessMode
);
11596 _Post_writable_byte_size_(MemoryDescriptorList
->ByteCount
)
11597 _When_(AccessMode
==KernelMode
, _IRQL_requires_max_(DISPATCH_LEVEL
))
11598 _When_(AccessMode
==UserMode
, _Maybe_raises_SEH_exception_
_IRQL_requires_max_(APC_LEVEL
) _Post_notnull_
)
11599 _At_(MemoryDescriptorList
->MappedSystemVa
, _Post_writable_byte_size_(MemoryDescriptorList
->ByteCount
))
11600 _Must_inspect_result_
11601 _Success_(return != NULL
)
11605 MmMapLockedPagesSpecifyCache(
11606 _Inout_ PMDLX MemoryDescriptorList
,
11607 _In_
__drv_strictType(KPROCESSOR_MODE
/enum _MODE
,__drv_typeConst
)
11608 KPROCESSOR_MODE AccessMode
,
11609 _In_
__drv_strictTypeMatch(__drv_typeCond
) MEMORY_CACHING_TYPE CacheType
,
11610 _In_opt_ PVOID BaseAddress
,
11611 _In_ ULONG BugCheckOnFailure
,
11612 _In_ MM_PAGE_PRIORITY Priority
);
11614 _IRQL_requires_max_(APC_LEVEL
)
11618 MmPageEntireDriver(
11619 _In_ PVOID AddressWithinSection
);
11621 _IRQL_requires_max_(DISPATCH_LEVEL
)
11622 _At_(MemoryDescriptorList
->StartVa
+ MemoryDescriptorList
->ByteOffset
,
11623 _Field_size_bytes_opt_(MemoryDescriptorList
->ByteCount
))
11627 MmProbeAndLockPages(
11628 _Inout_ PMDLX MemoryDescriptorList
,
11629 _In_ KPROCESSOR_MODE AccessMode
,
11630 _In_ LOCK_OPERATION Operation
);
11635 MmQuerySystemSize(VOID
);
11637 _IRQL_requires_max_(APC_LEVEL
)
11641 MmResetDriverPaging(
11642 _In_ PVOID AddressWithinSection
);
11648 _In_reads_bytes_opt_ (Length
) PVOID Base
,
11649 _In_ SIZE_T Length
);
11651 _IRQL_requires_max_(DISPATCH_LEVEL
)
11655 MmUnlockPagableImageSection(
11656 _In_ PVOID ImageSectionHandle
);
11658 _IRQL_requires_max_(DISPATCH_LEVEL
)
11663 _Inout_ PMDLX MemoryDescriptorList
);
11665 _IRQL_requires_max_(DISPATCH_LEVEL
)
11670 _In_reads_bytes_ (NumberOfBytes
) PVOID BaseAddress
,
11671 _In_ SIZE_T NumberOfBytes
);
11673 _IRQL_requires_max_ (APC_LEVEL
)
11677 MmProbeAndLockProcessPages(
11678 _Inout_ PMDL MemoryDescriptorList
,
11679 _In_ PEPROCESS Process
,
11680 _In_ KPROCESSOR_MODE AccessMode
,
11681 _In_ LOCK_OPERATION Operation
);
11683 _IRQL_requires_max_(DISPATCH_LEVEL
)
11687 MmUnmapLockedPages(
11688 _In_ PVOID BaseAddress
,
11689 _Inout_ PMDL MemoryDescriptorList
);
11691 _Must_inspect_result_
11692 _IRQL_requires_max_(DISPATCH_LEVEL
)
11693 _When_ (return != NULL
, _Post_writable_byte_size_ (NumberOfBytes
))
11697 MmAllocateContiguousMemorySpecifyCacheNode(
11698 _In_ SIZE_T NumberOfBytes
,
11699 _In_ PHYSICAL_ADDRESS LowestAcceptableAddress
,
11700 _In_ PHYSICAL_ADDRESS HighestAcceptableAddress
,
11701 _In_opt_ PHYSICAL_ADDRESS BoundaryAddressMultiple
,
11702 _In_ MEMORY_CACHING_TYPE CacheType
,
11703 _In_ NODE_REQUIREMENT PreferredNode
);
11705 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
11707 #if (NTDDI_VERSION >= NTDDI_WINXP)
11709 _IRQL_requires_max_(DISPATCH_LEVEL
)
11715 _In_ ULONG NumberOfBytes
);
11717 _Must_inspect_result_
11718 _IRQL_requires_max_(APC_LEVEL
)
11719 _When_ (return != NULL
, _Out_writes_bytes_opt_ (NumberOfBytes
))
11723 MmAllocateMappingAddress(
11724 _In_ SIZE_T NumberOfBytes
,
11725 _In_ ULONG PoolTag
);
11727 _IRQL_requires_max_(APC_LEVEL
)
11731 MmFreeMappingAddress(
11732 _In_ PVOID BaseAddress
,
11733 _In_ ULONG PoolTag
);
11735 _IRQL_requires_max_ (APC_LEVEL
)
11739 MmIsVerifierEnabled(
11740 _Out_ PULONG VerifierFlags
);
11742 _Post_writable_byte_size_(MemoryDescriptorList
->ByteCount
)
11743 _IRQL_requires_max_(DISPATCH_LEVEL
)
11744 _At_(MemoryDescriptorList
->MappedSystemVa
+ MemoryDescriptorList
->ByteOffset
,
11745 _Post_writable_byte_size_(MemoryDescriptorList
->ByteCount
))
11746 _Must_inspect_result_
11747 _Success_(return != NULL
)
11751 MmMapLockedPagesWithReservedMapping(
11752 _In_ PVOID MappingAddress
,
11753 _In_ ULONG PoolTag
,
11754 _Inout_ PMDLX MemoryDescriptorList
,
11755 _In_
__drv_strictTypeMatch(__drv_typeCond
)
11756 MEMORY_CACHING_TYPE CacheType
);
11758 _Must_inspect_result_
11759 _IRQL_requires_max_(DISPATCH_LEVEL
)
11763 MmProtectMdlSystemAddress(
11764 _In_ PMDLX MemoryDescriptorList
,
11765 _In_ ULONG NewProtect
);
11767 _IRQL_requires_max_(DISPATCH_LEVEL
)
11771 MmUnmapReservedMapping(
11772 _In_ PVOID BaseAddress
,
11773 _In_ ULONG PoolTag
,
11774 _Inout_ PMDLX MemoryDescriptorList
);
11776 _IRQL_requires_max_ (APC_LEVEL
)
11780 MmAddVerifierThunks(
11781 _In_reads_bytes_ (ThunkBufferSize
) PVOID ThunkBuffer
,
11782 _In_ ULONG ThunkBufferSize
);
11784 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) */
11785 #if (NTDDI_VERSION >= NTDDI_WS03)
11786 _IRQL_requires_max_ (DISPATCH_LEVEL
)
11791 _In_ PHYSICAL_ADDRESS StartAddress
,
11792 _In_ SIZE_T NumberOfBytes
);
11794 #endif /* (NTDDI_VERSION >= NTDDI_WS03) */
11795 #if (NTDDI_VERSION >= NTDDI_WS03SP1)
11796 _Must_inspect_result_
11797 _IRQL_requires_max_ (DISPATCH_LEVEL
)
11801 MmAllocatePagesForMdlEx(
11802 _In_ PHYSICAL_ADDRESS LowAddress
,
11803 _In_ PHYSICAL_ADDRESS HighAddress
,
11804 _In_ PHYSICAL_ADDRESS SkipBytes
,
11805 _In_ SIZE_T TotalBytes
,
11806 _In_ MEMORY_CACHING_TYPE CacheType
,
11810 #if (NTDDI_VERSION >= NTDDI_VISTA)
11811 _IRQL_requires_max_ (APC_LEVEL
)
11815 MmIsDriverVerifyingByAddress(
11816 _In_ PVOID AddressWithinSection
);
11817 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
11819 /******************************************************************************
11820 * Security Manager Functions *
11821 ******************************************************************************/
11823 #if (NTDDI_VERSION >= NTDDI_WIN2K)
11824 _IRQL_requires_max_(PASSIVE_LEVEL
)
11829 _In_ PSECURITY_DESCRIPTOR SecurityDescriptor
,
11830 _In_ PSECURITY_SUBJECT_CONTEXT SubjectSecurityContext
,
11831 _In_ BOOLEAN SubjectContextLocked
,
11832 _In_ ACCESS_MASK DesiredAccess
,
11833 _In_ ACCESS_MASK PreviouslyGrantedAccess
,
11834 _Outptr_opt_ PPRIVILEGE_SET
*Privileges
,
11835 _In_ PGENERIC_MAPPING GenericMapping
,
11836 _In_ KPROCESSOR_MODE AccessMode
,
11837 _Out_ PACCESS_MASK GrantedAccess
,
11838 _Out_ PNTSTATUS AccessStatus
);
11840 _IRQL_requires_max_(PASSIVE_LEVEL
)
11845 _In_opt_ PSECURITY_DESCRIPTOR ParentDescriptor
,
11846 _In_opt_ PSECURITY_DESCRIPTOR ExplicitDescriptor
,
11847 _Out_ PSECURITY_DESCRIPTOR
*NewDescriptor
,
11848 _In_ BOOLEAN IsDirectoryObject
,
11849 _In_ PSECURITY_SUBJECT_CONTEXT SubjectContext
,
11850 _In_ PGENERIC_MAPPING GenericMapping
,
11851 _In_ POOL_TYPE PoolType
);
11856 SeAssignSecurityEx(
11857 _In_opt_ PSECURITY_DESCRIPTOR ParentDescriptor
,
11858 _In_opt_ PSECURITY_DESCRIPTOR ExplicitDescriptor
,
11859 _Out_ PSECURITY_DESCRIPTOR
*NewDescriptor
,
11860 _In_opt_ GUID
*ObjectType
,
11861 _In_ BOOLEAN IsDirectoryObject
,
11862 _In_ ULONG AutoInheritFlags
,
11863 _In_ PSECURITY_SUBJECT_CONTEXT SubjectContext
,
11864 _In_ PGENERIC_MAPPING GenericMapping
,
11865 _In_ POOL_TYPE PoolType
);
11867 _IRQL_requires_max_(PASSIVE_LEVEL
)
11871 SeDeassignSecurity(
11872 _Inout_ PSECURITY_DESCRIPTOR
*SecurityDescriptor
);
11874 _IRQL_requires_max_(PASSIVE_LEVEL
)
11878 SeValidSecurityDescriptor(
11880 _In_reads_bytes_(Length
) PSECURITY_DESCRIPTOR SecurityDescriptor
);
11885 SeObjectCreateSaclAccessBits(
11886 _In_ PSECURITY_DESCRIPTOR SecurityDescriptor
);
11891 SeReleaseSubjectContext(
11892 _Inout_ PSECURITY_SUBJECT_CONTEXT SubjectContext
);
11897 SeUnlockSubjectContext(
11898 _In_ PSECURITY_SUBJECT_CONTEXT SubjectContext
);
11903 SeCaptureSubjectContext(
11904 _Out_ PSECURITY_SUBJECT_CONTEXT SubjectContext
);
11909 SeLockSubjectContext(
11910 _In_ PSECURITY_SUBJECT_CONTEXT SubjectContext
);
11913 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
11915 #if (NTDDI_VERSION >= NTDDI_WS03SP1)
11917 _At_(AuditParameters
->ParameterCount
, _Const_
)
11920 SeSetAuditParameter(
11921 _Inout_ PSE_ADT_PARAMETER_ARRAY AuditParameters
,
11922 _In_ SE_ADT_PARAMETER_TYPE Type
,
11923 _In_range_(<,SE_MAX_AUDIT_PARAMETERS
) ULONG Index
,
11924 _In_reads_(_Inexpressible_("depends on SE_ADT_PARAMETER_TYPE"))
11929 SeReportSecurityEvent(
11931 _In_ PUNICODE_STRING SourceName
,
11932 _In_opt_ PSID UserSid
,
11933 _In_ PSE_ADT_PARAMETER_ARRAY AuditParameters
);
11935 #endif /* (NTDDI_VERSION >= NTDDI_WS03SP1) */
11937 #if (NTDDI_VERSION >= NTDDI_VISTA)
11941 SeComputeAutoInheritByObjectType(
11942 _In_ PVOID ObjectType
,
11943 _In_opt_ PSECURITY_DESCRIPTOR SecurityDescriptor
,
11944 _In_opt_ PSECURITY_DESCRIPTOR ParentSecurityDescriptor
);
11946 #ifdef SE_NTFS_WORLD_CACHE
11950 _In_ PSECURITY_DESCRIPTOR SecurityDescriptor
,
11951 _In_ PGENERIC_MAPPING GenericMapping
,
11952 _Out_ PACCESS_MASK GrantedAccess
);
11953 #endif /* SE_NTFS_WORLD_CACHE */
11954 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
11955 /******************************************************************************
11956 * Configuration Manager Functions *
11957 ******************************************************************************/
11959 #if (NTDDI_VERSION >= NTDDI_WINXP)
11960 _IRQL_requires_max_(APC_LEVEL
)
11964 CmRegisterCallback(
11965 _In_ PEX_CALLBACK_FUNCTION Function
,
11966 _In_opt_ PVOID Context
,
11967 _Out_ PLARGE_INTEGER Cookie
);
11969 _IRQL_requires_max_(APC_LEVEL
)
11973 CmUnRegisterCallback(
11974 _In_ LARGE_INTEGER Cookie
);
11977 #if (NTDDI_VERSION >= NTDDI_VISTA)
11979 _IRQL_requires_max_(APC_LEVEL
)
11983 CmRegisterCallbackEx(
11984 _In_ PEX_CALLBACK_FUNCTION Function
,
11985 _In_ PCUNICODE_STRING Altitude
,
11987 _In_opt_ PVOID Context
,
11988 _Out_ PLARGE_INTEGER Cookie
,
11989 _Reserved_ PVOID Reserved
);
11991 _IRQL_requires_max_(APC_LEVEL
)
11995 CmGetCallbackVersion(
11996 _Out_opt_ PULONG Major
,
11997 _Out_opt_ PULONG Minor
);
11999 _IRQL_requires_max_(APC_LEVEL
)
12003 CmSetCallbackObjectContext(
12004 _Inout_ PVOID Object
,
12005 _In_ PLARGE_INTEGER Cookie
,
12006 _In_ PVOID NewContext
,
12007 _Out_opt_ PVOID
*OldContext
);
12009 _IRQL_requires_max_(APC_LEVEL
)
12013 CmCallbackGetKeyObjectID(
12014 _In_ PLARGE_INTEGER Cookie
,
12016 _Out_opt_ PULONG_PTR ObjectID
,
12017 _Outptr_opt_ PCUNICODE_STRING
*ObjectName
);
12019 _IRQL_requires_max_(APC_LEVEL
)
12023 CmGetBoundTransaction(
12024 _In_ PLARGE_INTEGER Cookie
,
12025 _In_ PVOID Object
);
12027 #endif // NTDDI_VERSION >= NTDDI_VISTA
12030 /******************************************************************************
12031 * I/O Manager Functions *
12032 ******************************************************************************/
12036 * IoAcquireRemoveLock(
12037 * IN PIO_REMOVE_LOCK RemoveLock,
12038 * IN OPTIONAL PVOID Tag)
12041 #define IoAcquireRemoveLock(RemoveLock, Tag) \
12042 IoAcquireRemoveLockEx(RemoveLock, Tag, __FILE__, __LINE__, sizeof (IO_REMOVE_LOCK))
12044 #define IoAcquireRemoveLock(RemoveLock, Tag) \
12045 IoAcquireRemoveLockEx(RemoveLock, Tag, "", 1, sizeof (IO_REMOVE_LOCK))
12050 * IoAdjustPagingPathCount(
12052 * IN BOOLEAN Increment)
12054 #define IoAdjustPagingPathCount(_Count, \
12059 InterlockedIncrement(_Count); \
12063 InterlockedDecrement(_Count); \
12067 #if !defined(_M_AMD64)
12071 READ_PORT_BUFFER_UCHAR(
12079 READ_PORT_BUFFER_ULONG(
12087 READ_PORT_BUFFER_USHORT(
12113 READ_REGISTER_BUFFER_UCHAR(
12114 IN PUCHAR Register
,
12121 READ_REGISTER_BUFFER_ULONG(
12122 IN PULONG Register
,
12129 READ_REGISTER_BUFFER_USHORT(
12130 IN PUSHORT Register
,
12137 READ_REGISTER_UCHAR(
12138 IN PUCHAR Register
);
12143 READ_REGISTER_ULONG(
12144 IN PULONG Register
);
12149 READ_REGISTER_USHORT(
12150 IN PUSHORT Register
);
12155 WRITE_PORT_BUFFER_UCHAR(
12163 WRITE_PORT_BUFFER_ULONG(
12171 WRITE_PORT_BUFFER_USHORT(
12200 WRITE_REGISTER_BUFFER_UCHAR(
12201 IN PUCHAR Register
,
12208 WRITE_REGISTER_BUFFER_ULONG(
12209 IN PULONG Register
,
12216 WRITE_REGISTER_BUFFER_USHORT(
12217 IN PUSHORT Register
,
12224 WRITE_REGISTER_UCHAR(
12225 IN PUCHAR Register
,
12231 WRITE_REGISTER_ULONG(
12232 IN PULONG Register
,
12238 WRITE_REGISTER_USHORT(
12239 IN PUSHORT Register
,
12246 READ_PORT_BUFFER_UCHAR(
12251 __inbytestring((USHORT
)(ULONG_PTR
)Port
, Buffer
, Count
);
12256 READ_PORT_BUFFER_ULONG(
12261 __indwordstring((USHORT
)(ULONG_PTR
)Port
, Buffer
, Count
);
12266 READ_PORT_BUFFER_USHORT(
12271 __inwordstring((USHORT
)(ULONG_PTR
)Port
, Buffer
, Count
);
12279 return __inbyte((USHORT
)(ULONG_PTR
)Port
);
12287 return __indword((USHORT
)(ULONG_PTR
)Port
);
12295 return __inword((USHORT
)(ULONG_PTR
)Port
);
12300 READ_REGISTER_BUFFER_UCHAR(
12301 IN PUCHAR Register
,
12305 __movsb(Register
, Buffer
, Count
);
12310 READ_REGISTER_BUFFER_ULONG(
12311 IN PULONG Register
,
12315 __movsd(Register
, Buffer
, Count
);
12320 READ_REGISTER_BUFFER_USHORT(
12321 IN PUSHORT Register
,
12325 __movsw(Register
, Buffer
, Count
);
12330 READ_REGISTER_UCHAR(
12331 IN
volatile UCHAR
*Register
)
12338 READ_REGISTER_ULONG(
12339 IN
volatile ULONG
*Register
)
12346 READ_REGISTER_USHORT(
12347 IN
volatile USHORT
*Register
)
12354 WRITE_PORT_BUFFER_UCHAR(
12359 __outbytestring((USHORT
)(ULONG_PTR
)Port
, Buffer
, Count
);
12364 WRITE_PORT_BUFFER_ULONG(
12369 __outdwordstring((USHORT
)(ULONG_PTR
)Port
, Buffer
, Count
);
12374 WRITE_PORT_BUFFER_USHORT(
12379 __outwordstring((USHORT
)(ULONG_PTR
)Port
, Buffer
, Count
);
12388 __outbyte((USHORT
)(ULONG_PTR
)Port
, Value
);
12397 __outdword((USHORT
)(ULONG_PTR
)Port
, Value
);
12406 __outword((USHORT
)(ULONG_PTR
)Port
, Value
);
12411 WRITE_REGISTER_BUFFER_UCHAR(
12412 IN PUCHAR Register
,
12417 __movsb(Register
, Buffer
, Count
);
12418 InterlockedOr(&Synch
, 1);
12423 WRITE_REGISTER_BUFFER_ULONG(
12424 IN PULONG Register
,
12429 __movsd(Register
, Buffer
, Count
);
12430 InterlockedOr(&Synch
, 1);
12435 WRITE_REGISTER_BUFFER_USHORT(
12436 IN PUSHORT Register
,
12441 __movsw(Register
, Buffer
, Count
);
12442 InterlockedOr(&Synch
, 1);
12447 WRITE_REGISTER_UCHAR(
12448 IN
volatile UCHAR
*Register
,
12453 InterlockedOr(&Synch
, 1);
12458 WRITE_REGISTER_ULONG(
12459 IN
volatile ULONG
*Register
,
12464 InterlockedOr(&Synch
, 1);
12469 WRITE_REGISTER_USHORT(
12470 IN
volatile USHORT
*Register
,
12475 InterlockedOr(&Sync
, 1);
12479 #if defined(USE_DMA_MACROS) && !defined(_NTHAL_) && \
12480 (defined(_NTDDK_) || defined(_NTDRIVER_)) || defined(_WDM_INCLUDED_)
12482 #define DMA_MACROS_DEFINED
12484 _IRQL_requires_max_(DISPATCH_LEVEL
)
12485 _IRQL_requires_min_(DISPATCH_LEVEL
)
12488 IoAllocateAdapterChannel(
12489 _In_ PDMA_ADAPTER DmaAdapter
,
12490 _In_ PDEVICE_OBJECT DeviceObject
,
12491 _In_ ULONG NumberOfMapRegisters
,
12492 _In_ PDRIVER_CONTROL ExecutionRoutine
,
12493 _In_ PVOID Context
)
12495 PALLOCATE_ADAPTER_CHANNEL AllocateAdapterChannel
;
12496 AllocateAdapterChannel
=
12497 *(DmaAdapter
)->DmaOperations
->AllocateAdapterChannel
;
12498 ASSERT(AllocateAdapterChannel
);
12499 return AllocateAdapterChannel(DmaAdapter
,
12501 NumberOfMapRegisters
,
12509 IoFlushAdapterBuffers(
12510 _In_ PDMA_ADAPTER DmaAdapter
,
12512 _In_ PVOID MapRegisterBase
,
12513 _In_ PVOID CurrentVa
,
12515 _In_ BOOLEAN WriteToDevice
)
12517 PFLUSH_ADAPTER_BUFFERS FlushAdapterBuffers
;
12518 FlushAdapterBuffers
= *(DmaAdapter
)->DmaOperations
->FlushAdapterBuffers
;
12519 ASSERT(FlushAdapterBuffers
);
12520 return FlushAdapterBuffers(DmaAdapter
,
12531 IoFreeAdapterChannel(
12532 _In_ PDMA_ADAPTER DmaAdapter
)
12534 PFREE_ADAPTER_CHANNEL FreeAdapterChannel
;
12535 FreeAdapterChannel
= *(DmaAdapter
)->DmaOperations
->FreeAdapterChannel
;
12536 ASSERT(FreeAdapterChannel
);
12537 FreeAdapterChannel(DmaAdapter
);
12543 IoFreeMapRegisters(
12544 _In_ PDMA_ADAPTER DmaAdapter
,
12545 _In_ PVOID MapRegisterBase
,
12546 _In_ ULONG NumberOfMapRegisters
)
12548 PFREE_MAP_REGISTERS FreeMapRegisters
;
12549 FreeMapRegisters
= *(DmaAdapter
)->DmaOperations
->FreeMapRegisters
;
12550 ASSERT(FreeMapRegisters
);
12551 FreeMapRegisters(DmaAdapter
, MapRegisterBase
, NumberOfMapRegisters
);
12558 _In_ PDMA_ADAPTER DmaAdapter
,
12560 _In_ PVOID MapRegisterBase
,
12561 _In_ PVOID CurrentVa
,
12562 _Inout_ PULONG Length
,
12563 _In_ BOOLEAN WriteToDevice
)
12565 PMAP_TRANSFER MapTransfer
;
12567 MapTransfer
= *(DmaAdapter
)->DmaOperations
->MapTransfer
;
12568 ASSERT(MapTransfer
);
12569 return MapTransfer(DmaAdapter
,
12578 #if (NTDDI_VERSION >= NTDDI_WIN2K)
12580 _Acquires_lock_(_Global_cancel_spin_lock_
)
12581 _Requires_lock_not_held_(_Global_cancel_spin_lock_
)
12582 _IRQL_requires_max_(DISPATCH_LEVEL
)
12583 _IRQL_raises_(DISPATCH_LEVEL
)
12587 IoAcquireCancelSpinLock(
12588 _Out_
_At_(*Irql
, _IRQL_saves_
) PKIRQL Irql
);
12590 _IRQL_requires_max_(DISPATCH_LEVEL
)
12594 IoAcquireRemoveLockEx(
12595 _Inout_ PIO_REMOVE_LOCK RemoveLock
,
12596 _In_opt_ PVOID Tag
,
12599 _In_ ULONG RemlockSize
);
12601 _IRQL_requires_max_(DISPATCH_LEVEL
)
12606 IoAllocateDriverObjectExtension(
12607 _In_ PDRIVER_OBJECT DriverObject
,
12608 _In_ PVOID ClientIdentificationAddress
,
12609 _In_ ULONG DriverObjectExtensionSize
,
12610 _Post_
_At_(*DriverObjectExtension
, _When_(return==0,
12611 __drv_aliasesMem
__drv_allocatesMem(Mem
) _Post_notnull_
))
12612 _When_(return == 0, _Outptr_result_bytebuffer_(DriverObjectExtensionSize
))
12613 PVOID
*DriverObjectExtension
);
12615 _IRQL_requires_max_(DISPATCH_LEVEL
)
12619 IoAllocateErrorLogEntry(
12620 _In_ PVOID IoObject
,
12621 _In_ UCHAR EntrySize
);
12623 _Must_inspect_result_
12624 _IRQL_requires_max_(DISPATCH_LEVEL
)
12629 _In_ CCHAR StackSize
,
12630 _In_ BOOLEAN ChargeQuota
);
12632 _IRQL_requires_max_(DISPATCH_LEVEL
)
12637 _In_opt_ __drv_aliasesMem PVOID VirtualAddress
,
12639 _In_ BOOLEAN SecondaryBuffer
,
12640 _In_ BOOLEAN ChargeQuota
,
12641 _Inout_opt_ PIRP Irp
);
12643 __drv_allocatesMem(Mem
)
12644 _IRQL_requires_max_(DISPATCH_LEVEL
)
12648 IoAllocateWorkItem(
12649 _In_ PDEVICE_OBJECT DeviceObject
);
12651 _IRQL_requires_max_(APC_LEVEL
)
12657 _In_
_Kernel_requires_resource_held_(Memory
) _When_(return==0, __drv_aliasesMem
)
12658 PDEVICE_OBJECT SourceDevice
,
12659 _In_ PUNICODE_STRING TargetDevice
,
12660 _Out_ PDEVICE_OBJECT
*AttachedDevice
);
12662 _Must_inspect_result_
12663 _IRQL_requires_max_(DISPATCH_LEVEL
)
12667 IoAttachDeviceToDeviceStack(
12668 _In_
_Kernel_requires_resource_held_(Memory
) _When_(return!=0, __drv_aliasesMem
)
12669 PDEVICE_OBJECT SourceDevice
,
12670 _In_ PDEVICE_OBJECT TargetDevice
);
12672 _Must_inspect_result_
12674 _IRQL_requires_max_(DISPATCH_LEVEL
)
12678 IoBuildAsynchronousFsdRequest(
12679 _In_ ULONG MajorFunction
,
12680 _In_ PDEVICE_OBJECT DeviceObject
,
12681 _Inout_opt_ PVOID Buffer
,
12682 _In_opt_ ULONG Length
,
12683 _In_opt_ PLARGE_INTEGER StartingOffset
,
12684 _In_opt_ PIO_STATUS_BLOCK IoStatusBlock
);
12686 _Must_inspect_result_
12688 _IRQL_requires_max_(PASSIVE_LEVEL
)
12692 IoBuildDeviceIoControlRequest(
12693 _In_ ULONG IoControlCode
,
12694 _In_ PDEVICE_OBJECT DeviceObject
,
12695 _In_opt_ PVOID InputBuffer
,
12696 _In_ ULONG InputBufferLength
,
12697 _Out_opt_ PVOID OutputBuffer
,
12698 _In_ ULONG OutputBufferLength
,
12699 _In_ BOOLEAN InternalDeviceIoControl
,
12700 _In_opt_ PKEVENT Event
,
12701 _Out_ PIO_STATUS_BLOCK IoStatusBlock
);
12703 _IRQL_requires_max_(DISPATCH_LEVEL
)
12708 _In_ PMDL SourceMdl
,
12709 _Inout_ PMDL TargetMdl
,
12710 _In_ PVOID VirtualAddress
,
12711 _In_ ULONG Length
);
12713 _Must_inspect_result_
12715 _IRQL_requires_max_(PASSIVE_LEVEL
)
12719 IoBuildSynchronousFsdRequest(
12720 _In_ ULONG MajorFunction
,
12721 _In_ PDEVICE_OBJECT DeviceObject
,
12722 _Inout_opt_ PVOID Buffer
,
12723 _In_opt_ ULONG Length
,
12724 _In_opt_ PLARGE_INTEGER StartingOffset
,
12725 _In_ PKEVENT Event
,
12726 _Out_ PIO_STATUS_BLOCK IoStatusBlock
);
12728 _IRQL_requires_max_(DISPATCH_LEVEL
)
12734 _In_ PDEVICE_OBJECT DeviceObject
,
12735 _Inout_ __drv_aliasesMem PIRP Irp
);
12736 #define IoCallDriver IofCallDriver
12738 _IRQL_requires_max_(DISPATCH_LEVEL
)
12742 IofCompleteRequest(
12744 _In_ CCHAR PriorityBoost
);
12745 #define IoCompleteRequest IofCompleteRequest
12747 _IRQL_requires_max_(DISPATCH_LEVEL
)
12754 _IRQL_requires_max_(PASSIVE_LEVEL
)
12758 IoCheckShareAccess(
12759 _In_ ACCESS_MASK DesiredAccess
,
12760 _In_ ULONG DesiredShareAccess
,
12761 _Inout_ PFILE_OBJECT FileObject
,
12762 _Inout_ PSHARE_ACCESS ShareAccess
,
12763 _In_ BOOLEAN Update
);
12765 _IRQL_requires_max_(DISPATCH_LEVEL
)
12769 IofCompleteRequest(
12771 _In_ CCHAR PriorityBoost
);
12773 _IRQL_requires_max_(PASSIVE_LEVEL
)
12777 IoConnectInterrupt(
12778 _Out_ PKINTERRUPT
*InterruptObject
,
12779 _In_ PKSERVICE_ROUTINE ServiceRoutine
,
12780 _In_opt_ PVOID ServiceContext
,
12781 _In_opt_ PKSPIN_LOCK SpinLock
,
12784 _In_ KIRQL SynchronizeIrql
,
12785 _In_ KINTERRUPT_MODE InterruptMode
,
12786 _In_ BOOLEAN ShareVector
,
12787 _In_ KAFFINITY ProcessorEnableMask
,
12788 _In_ BOOLEAN FloatingSave
);
12790 _IRQL_requires_max_(APC_LEVEL
)
12796 _In_ PDRIVER_OBJECT DriverObject
,
12797 _In_ ULONG DeviceExtensionSize
,
12798 _In_opt_ PUNICODE_STRING DeviceName
,
12799 _In_ DEVICE_TYPE DeviceType
,
12800 _In_ ULONG DeviceCharacteristics
,
12801 _In_ BOOLEAN Exclusive
,
12802 _Outptr_result_nullonfailure_
12803 _At_(*DeviceObject
,
12804 __drv_allocatesMem(Mem
)
12805 _When_(((_In_function_class_(DRIVER_INITIALIZE
))
12806 ||(_In_function_class_(DRIVER_DISPATCH
))),
12808 PDEVICE_OBJECT
*DeviceObject
);
12810 _IRQL_requires_max_(PASSIVE_LEVEL
)
12815 _Out_ PHANDLE FileHandle
,
12816 _In_ ACCESS_MASK DesiredAccess
,
12817 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
12818 _Out_ PIO_STATUS_BLOCK IoStatusBlock
,
12819 _In_opt_ PLARGE_INTEGER AllocationSize
,
12820 _In_ ULONG FileAttributes
,
12821 _In_ ULONG ShareAccess
,
12822 _In_ ULONG Disposition
,
12823 _In_ ULONG CreateOptions
,
12824 _In_opt_ PVOID EaBuffer
,
12825 _In_ ULONG EaLength
,
12826 _In_ CREATE_FILE_TYPE CreateFileType
,
12827 _In_opt_ PVOID InternalParameters
,
12828 _In_ ULONG Options
);
12830 _IRQL_requires_max_(PASSIVE_LEVEL
)
12834 IoCreateNotificationEvent(
12835 _In_ PUNICODE_STRING EventName
,
12836 _Out_ PHANDLE EventHandle
);
12838 _IRQL_requires_max_(PASSIVE_LEVEL
)
12842 IoCreateSymbolicLink(
12843 _In_ PUNICODE_STRING SymbolicLinkName
,
12844 _In_ PUNICODE_STRING DeviceName
);
12846 _IRQL_requires_max_(PASSIVE_LEVEL
)
12850 IoCreateSynchronizationEvent(
12851 _In_ PUNICODE_STRING EventName
,
12852 _Out_ PHANDLE EventHandle
);
12854 _IRQL_requires_max_(PASSIVE_LEVEL
)
12858 IoCreateUnprotectedSymbolicLink(
12859 _In_ PUNICODE_STRING SymbolicLinkName
,
12860 _In_ PUNICODE_STRING DeviceName
);
12862 _IRQL_requires_max_(APC_LEVEL
)
12863 _Kernel_clear_do_init_(__yes
)
12868 _In_
_Kernel_requires_resource_held_(Memory
) __drv_freesMem(Mem
)
12869 PDEVICE_OBJECT DeviceObject
);
12871 _IRQL_requires_max_(PASSIVE_LEVEL
)
12875 IoDeleteSymbolicLink(
12876 _In_ PUNICODE_STRING SymbolicLinkName
);
12878 _IRQL_requires_max_(PASSIVE_LEVEL
)
12883 _Inout_ PDEVICE_OBJECT TargetDevice
);
12885 _IRQL_requires_max_(PASSIVE_LEVEL
)
12889 IoDisconnectInterrupt(
12890 _In_ PKINTERRUPT InterruptObject
);
12892 __drv_freesMem(Mem
)
12893 _IRQL_requires_max_(DISPATCH_LEVEL
)
12900 _IRQL_requires_max_(DISPATCH_LEVEL
)
12907 _IRQL_requires_max_(DISPATCH_LEVEL
)
12912 _In_
__drv_freesMem(Mem
) PIO_WORKITEM IoWorkItem
);
12917 IoGetAttachedDevice(
12918 IN PDEVICE_OBJECT DeviceObject
);
12920 _IRQL_requires_max_(DISPATCH_LEVEL
)
12924 IoGetAttachedDeviceReference(
12925 _In_ PDEVICE_OBJECT DeviceObject
);
12930 IoGetBootDiskInformation(
12931 _Inout_ PBOOTDISK_INFORMATION BootDiskInformation
,
12934 _IRQL_requires_max_(PASSIVE_LEVEL
)
12935 _Must_inspect_result_
12939 IoGetDeviceInterfaceAlias(
12940 _In_ PUNICODE_STRING SymbolicLinkName
,
12941 _In_ CONST GUID
*AliasInterfaceClassGuid
,
12943 _When_(return==0, _At_(AliasSymbolicLinkName
->Buffer
, __drv_allocatesMem(Mem
)))
12944 PUNICODE_STRING AliasSymbolicLinkName
);
12949 IoGetCurrentProcess(VOID
);
12951 _IRQL_requires_max_(PASSIVE_LEVEL
)
12952 _Must_inspect_result_
12956 IoGetDeviceInterfaces(
12957 _In_ CONST GUID
*InterfaceClassGuid
,
12958 _In_opt_ PDEVICE_OBJECT PhysicalDeviceObject
,
12960 _Outptr_result_nullonfailure_
12961 _At_(*SymbolicLinkList
, _When_(return==0, __drv_allocatesMem(Mem
)))
12962 PZZWSTR
*SymbolicLinkList
);
12964 _IRQL_requires_max_(PASSIVE_LEVEL
)
12968 IoGetDeviceObjectPointer(
12969 _In_ PUNICODE_STRING ObjectName
,
12970 _In_ ACCESS_MASK DesiredAccess
,
12971 _Out_ PFILE_OBJECT
*FileObject
,
12972 _Out_ PDEVICE_OBJECT
*DeviceObject
);
12974 _IRQL_requires_max_(PASSIVE_LEVEL
)
12975 _When_((DeviceProperty
& __string_type
),
12976 _At_(PropertyBuffer
, _Post_z_
))
12977 _When_((DeviceProperty
& __multiString_type
),
12978 _At_(PropertyBuffer
, _Post_ _NullNull_terminated_
))
12982 IoGetDeviceProperty(
12983 _In_ PDEVICE_OBJECT DeviceObject
,
12984 _In_ DEVICE_REGISTRY_PROPERTY DeviceProperty
,
12985 _In_ ULONG BufferLength
,
12986 _Out_writes_bytes_opt_(BufferLength
) PVOID PropertyBuffer
,
12987 _Deref_out_range_(<=, BufferLength
) PULONG ResultLength
);
12989 _Must_inspect_result_
12990 _IRQL_requires_max_(PASSIVE_LEVEL
)
12995 _In_opt_ PDEVICE_OBJECT PhysicalDeviceObject
,
12996 _In_ PDEVICE_DESCRIPTION DeviceDescription
,
12997 _Out_
_When_(return!=0, _Kernel_IoGetDmaAdapter_
_At_(*NumberOfMapRegisters
, _Must_inspect_result_
))
12998 PULONG NumberOfMapRegisters
);
13001 _IRQL_requires_max_(DISPATCH_LEVEL
)
13005 IoGetDriverObjectExtension(
13006 _In_ PDRIVER_OBJECT DriverObject
,
13007 _In_ PVOID ClientIdentificationAddress
);
13009 _IRQL_requires_max_(APC_LEVEL
)
13013 IoGetInitialStack(VOID
);
13018 IoGetRelatedDeviceObject(
13019 _In_ PFILE_OBJECT FileObject
);
13021 _IRQL_requires_max_(DISPATCH_LEVEL
)
13026 _Inout_ PIO_WORKITEM IoWorkItem
,
13027 _In_ PIO_WORKITEM_ROUTINE WorkerRoutine
,
13028 _In_ WORK_QUEUE_TYPE QueueType
,
13029 _In_opt_ __drv_aliasesMem PVOID Context
);
13031 _IRQL_requires_max_(DISPATCH_LEVEL
)
13037 _In_ USHORT PacketSize
,
13038 _In_ CCHAR StackSize
);
13040 _IRQL_requires_max_(PASSIVE_LEVEL
)
13044 IoInitializeRemoveLockEx(
13045 _Out_ PIO_REMOVE_LOCK Lock
,
13046 _In_ ULONG AllocateTag
,
13047 _In_ ULONG MaxLockedMinutes
,
13048 _In_ ULONG HighWatermark
,
13049 _In_ ULONG RemlockSize
);
13051 _IRQL_requires_max_(PASSIVE_LEVEL
)
13056 _In_ PDEVICE_OBJECT DeviceObject
,
13057 _In_ PIO_TIMER_ROUTINE TimerRoutine
,
13058 _In_opt_ __drv_aliasesMem PVOID Context
);
13060 _IRQL_requires_max_(DISPATCH_LEVEL
)
13064 IoInvalidateDeviceRelations(
13065 _In_ PDEVICE_OBJECT DeviceObject
,
13066 _In_ DEVICE_RELATION_TYPE Type
);
13068 _IRQL_requires_max_(DISPATCH_LEVEL
)
13072 IoInvalidateDeviceState(
13073 _In_ PDEVICE_OBJECT PhysicalDeviceObject
);
13075 _IRQL_requires_max_(PASSIVE_LEVEL
)
13079 IoIsWdmVersionAvailable(
13080 _When_(MajorVersion
!=1&&MajorVersion
!=6, _In_
__drv_reportError("MajorVersion must be 1 or 6"))
13081 UCHAR MajorVersion
,
13082 _In_
_When_(MinorVersion
!=0 && MinorVersion
!=5 &&
13083 MinorVersion
!=16 && MinorVersion
!=32 &&
13084 MinorVersion
!=48, __drv_reportError("MinorVersion must be 0, 0x5, 0x10, 0x20, or 0x30"))
13085 UCHAR MinorVersion
);
13087 _IRQL_requires_max_(PASSIVE_LEVEL
)
13088 _Must_inspect_result_
13092 IoOpenDeviceInterfaceRegistryKey(
13093 _In_ PUNICODE_STRING SymbolicLinkName
,
13094 _In_ ACCESS_MASK DesiredAccess
,
13095 _Out_ PHANDLE DeviceInterfaceKey
);
13097 _IRQL_requires_max_(PASSIVE_LEVEL
)
13098 _Must_inspect_result_
13102 IoOpenDeviceRegistryKey(
13103 _In_ PDEVICE_OBJECT DeviceObject
,
13104 _In_ ULONG DevInstKeyType
,
13105 _In_ ACCESS_MASK DesiredAccess
,
13106 _Out_ PHANDLE DevInstRegKey
);
13108 _IRQL_requires_max_(PASSIVE_LEVEL
)
13109 _Must_inspect_result_
13113 IoRegisterDeviceInterface(
13114 _In_ PDEVICE_OBJECT PhysicalDeviceObject
,
13115 _In_ CONST GUID
*InterfaceClassGuid
,
13116 _In_opt_ PUNICODE_STRING ReferenceString
,
13117 _Out_
_When_(return==0, _At_(SymbolicLinkName
->Buffer
, __drv_allocatesMem(Mem
)))
13118 PUNICODE_STRING SymbolicLinkName
);
13120 _IRQL_requires_max_(PASSIVE_LEVEL
)
13121 _Must_inspect_result_
13125 IoRegisterPlugPlayNotification(
13126 _In_ IO_NOTIFICATION_EVENT_CATEGORY EventCategory
,
13127 _In_ ULONG EventCategoryFlags
,
13128 _In_opt_ PVOID EventCategoryData
,
13129 _In_ PDRIVER_OBJECT DriverObject
,
13130 _In_ PDRIVER_NOTIFICATION_CALLBACK_ROUTINE CallbackRoutine
,
13131 _Inout_opt_ __drv_aliasesMem PVOID Context
,
13132 _Outptr_result_nullonfailure_
13133 _At_(*NotificationEntry
, _When_(return==0, __drv_allocatesMem(Mem
)))
13134 PVOID
*NotificationEntry
);
13136 _IRQL_requires_max_(PASSIVE_LEVEL
)
13140 IoRegisterShutdownNotification(
13141 _In_ PDEVICE_OBJECT DeviceObject
);
13143 _Requires_lock_held_(_Global_cancel_spin_lock_
)
13144 _Releases_lock_(_Global_cancel_spin_lock_
)
13145 _IRQL_requires_max_(DISPATCH_LEVEL
)
13146 _IRQL_requires_min_(DISPATCH_LEVEL
)
13150 IoReleaseCancelSpinLock(
13151 _In_ _IRQL_restores_ _IRQL_uses_cancel_ KIRQL Irql
);
13153 _IRQL_requires_max_(PASSIVE_LEVEL
)
13157 IoReleaseRemoveLockAndWaitEx(
13158 _Inout_ PIO_REMOVE_LOCK RemoveLock
,
13159 _In_opt_ PVOID Tag
,
13160 _In_ ULONG RemlockSize
);
13165 IoReleaseRemoveLockEx(
13166 _Inout_ PIO_REMOVE_LOCK RemoveLock
,
13167 _In_opt_ PVOID Tag
,
13168 _In_ ULONG RemlockSize
);
13170 _IRQL_requires_max_(PASSIVE_LEVEL
)
13174 IoRemoveShareAccess(
13175 _In_ PFILE_OBJECT FileObject
,
13176 _Inout_ PSHARE_ACCESS ShareAccess
);
13178 _IRQL_requires_max_(PASSIVE_LEVEL
)
13182 IoReportTargetDeviceChange(
13183 _In_ PDEVICE_OBJECT PhysicalDeviceObject
,
13184 _In_ PVOID NotificationStructure
);
13186 _IRQL_requires_max_(DISPATCH_LEVEL
)
13190 IoReportTargetDeviceChangeAsynchronous(
13191 _In_ PDEVICE_OBJECT PhysicalDeviceObject
,
13192 _In_ PVOID NotificationStructure
,
13193 _In_opt_ PDEVICE_CHANGE_COMPLETE_CALLBACK Callback
,
13194 _In_opt_ PVOID Context
);
13196 _IRQL_requires_max_(DISPATCH_LEVEL
)
13200 IoRequestDeviceEject(
13201 _In_ PDEVICE_OBJECT PhysicalDeviceObject
);
13203 _IRQL_requires_max_(DISPATCH_LEVEL
)
13209 _In_ NTSTATUS Status
);
13211 _IRQL_requires_max_(PASSIVE_LEVEL
)
13212 _Must_inspect_result_
13216 IoSetDeviceInterfaceState(
13217 _In_ PUNICODE_STRING SymbolicLinkName
,
13218 _In_ BOOLEAN Enable
);
13224 _In_ ACCESS_MASK DesiredAccess
,
13225 _In_ ULONG DesiredShareAccess
,
13226 _Inout_ PFILE_OBJECT FileObject
,
13227 _Out_ PSHARE_ACCESS ShareAccess
);
13229 _IRQL_requires_max_(DISPATCH_LEVEL
)
13230 _IRQL_requires_min_(DISPATCH_LEVEL
)
13235 _In_ PDEVICE_OBJECT DeviceObject
,
13236 _In_ BOOLEAN Cancelable
);
13238 _IRQL_requires_max_(DISPATCH_LEVEL
)
13242 IoStartNextPacketByKey(
13243 _In_ PDEVICE_OBJECT DeviceObject
,
13244 _In_ BOOLEAN Cancelable
,
13247 _IRQL_requires_max_(DISPATCH_LEVEL
)
13252 _In_ PDEVICE_OBJECT DeviceObject
,
13254 _In_opt_ PULONG Key
,
13255 _In_opt_ PDRIVER_CANCEL CancelFunction
);
13257 _IRQL_requires_max_(DISPATCH_LEVEL
)
13262 _In_ PDEVICE_OBJECT DeviceObject
);
13264 _IRQL_requires_max_(DISPATCH_LEVEL
)
13269 _In_ PDEVICE_OBJECT DeviceObject
);
13271 _IRQL_requires_max_(PASSIVE_LEVEL
)
13272 __drv_freesMem(Pool
)
13276 IoUnregisterPlugPlayNotification(
13277 _In_ PVOID NotificationEntry
);
13279 _IRQL_requires_max_(PASSIVE_LEVEL
)
13283 IoUnregisterShutdownNotification(
13284 _In_ PDEVICE_OBJECT DeviceObject
);
13286 _IRQL_requires_max_(PASSIVE_LEVEL
)
13290 IoUpdateShareAccess(
13291 _In_ PFILE_OBJECT FileObject
,
13292 _Inout_ PSHARE_ACCESS ShareAccess
);
13294 _IRQL_requires_max_(PASSIVE_LEVEL
)
13298 IoWMIAllocateInstanceIds(
13300 _In_ ULONG InstanceCount
,
13301 _Out_ ULONG
*FirstInstanceId
);
13306 IoWMIQuerySingleInstanceMultiple(
13307 _In_reads_(ObjectCount
) PVOID
*DataBlockObjectList
,
13308 _In_reads_(ObjectCount
) PUNICODE_STRING InstanceNames
,
13309 _In_ ULONG ObjectCount
,
13310 _Inout_ ULONG
*InOutBufferSize
,
13311 _Out_writes_bytes_opt_(*InOutBufferSize
) PVOID OutBuffer
);
13313 _IRQL_requires_max_(PASSIVE_LEVEL
)
13317 IoWMIRegistrationControl(
13318 _In_ PDEVICE_OBJECT DeviceObject
,
13319 _In_ ULONG Action
);
13324 IoWMISuggestInstanceName(
13325 _In_opt_ PDEVICE_OBJECT PhysicalDeviceObject
,
13326 _In_opt_ PUNICODE_STRING SymbolicLinkName
,
13327 _In_ BOOLEAN CombineNames
,
13328 _Out_ PUNICODE_STRING SuggestedInstanceName
);
13330 _Must_inspect_result_
13331 _IRQL_requires_max_(DISPATCH_LEVEL
)
13337 _Inout_
_When_(return==0, __drv_aliasesMem
) PVOID WnodeEventItem
);
13339 _IRQL_requires_max_(DISPATCH_LEVEL
)
13343 IoWriteErrorLogEntry(
13344 _In_ PVOID ElEntry
);
13349 IoGetTopLevelIrp(VOID
);
13351 _IRQL_requires_max_(PASSIVE_LEVEL
)
13355 IoRegisterLastChanceShutdownNotification(
13356 _In_ PDEVICE_OBJECT DeviceObject
);
13362 _In_opt_ PIRP Irp
);
13365 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
13368 #if (NTDDI_VERSION >= NTDDI_WINXP)
13375 _In_ PIO_CSQ_INSERT_IRP CsqInsertIrp
,
13376 _In_ PIO_CSQ_REMOVE_IRP CsqRemoveIrp
,
13377 _In_ PIO_CSQ_PEEK_NEXT_IRP CsqPeekNextIrp
,
13378 _In_ PIO_CSQ_ACQUIRE_LOCK CsqAcquireLock
,
13379 _In_ PIO_CSQ_RELEASE_LOCK CsqReleaseLock
,
13380 _In_ PIO_CSQ_COMPLETE_CANCELED_IRP CsqCompleteCanceledIrp
);
13386 _Inout_ PIO_CSQ Csq
,
13388 _Out_opt_ PIO_CSQ_IRP_CONTEXT Context
);
13394 _Inout_ PIO_CSQ Csq
,
13395 _Inout_ PIO_CSQ_IRP_CONTEXT Context
);
13400 IoCsqRemoveNextIrp(
13401 _Inout_ PIO_CSQ Csq
,
13402 _In_opt_ PVOID PeekContext
);
13407 IoForwardIrpSynchronously(
13408 _In_ PDEVICE_OBJECT DeviceObject
,
13411 #define IoForwardAndCatchIrp IoForwardIrpSynchronously
13416 IoFreeErrorLogEntry(
13417 _In_ PVOID ElEntry
);
13419 _IRQL_requires_max_(DISPATCH_LEVEL
)
13420 _Must_inspect_result_
13424 IoSetCompletionRoutineEx(
13425 _In_ PDEVICE_OBJECT DeviceObject
,
13427 _In_ PIO_COMPLETION_ROUTINE CompletionRoutine
,
13428 _In_opt_ PVOID Context
,
13429 _In_ BOOLEAN InvokeOnSuccess
,
13430 _In_ BOOLEAN InvokeOnError
,
13431 _In_ BOOLEAN InvokeOnCancel
);
13435 IoSetStartIoAttributes(
13436 _In_ PDEVICE_OBJECT DeviceObject
,
13437 _In_ BOOLEAN DeferredStartIo
,
13438 _In_ BOOLEAN NonCancelable
);
13443 IoWMIDeviceObjectToInstanceName(
13444 _In_ PVOID DataBlockObject
,
13445 _In_ PDEVICE_OBJECT DeviceObject
,
13446 _Out_ PUNICODE_STRING InstanceName
);
13451 IoWMIExecuteMethod(
13452 _In_ PVOID DataBlockObject
,
13453 _In_ PUNICODE_STRING InstanceName
,
13454 _In_ ULONG MethodId
,
13455 _In_ ULONG InBufferSize
,
13456 _Inout_ PULONG OutBufferSize
,
13457 _Inout_updates_bytes_to_opt_(*OutBufferSize
, InBufferSize
) PUCHAR InOutBuffer
);
13462 IoWMIHandleToInstanceName(
13463 _In_ PVOID DataBlockObject
,
13464 _In_ HANDLE FileHandle
,
13465 _Out_ PUNICODE_STRING InstanceName
);
13471 _In_ GUID
*DataBlockGuid
,
13472 _In_ ULONG DesiredAccess
,
13473 _Out_ PVOID
*DataBlockObject
);
13479 _In_ PVOID DataBlockObject
,
13480 _Inout_ ULONG
*InOutBufferSize
,
13481 _Out_writes_bytes_opt_(*InOutBufferSize
) PVOID OutBuffer
);
13486 IoWMIQueryAllDataMultiple(
13487 _In_reads_(ObjectCount
) PVOID
*DataBlockObjectList
,
13488 _In_ ULONG ObjectCount
,
13489 _Inout_ ULONG
*InOutBufferSize
,
13490 _Out_writes_bytes_opt_(*InOutBufferSize
) PVOID OutBuffer
);
13495 IoWMIQuerySingleInstance(
13496 _In_ PVOID DataBlockObject
,
13497 _In_ PUNICODE_STRING InstanceName
,
13498 _Inout_ ULONG
*InOutBufferSize
,
13499 _Out_writes_bytes_opt_(*InOutBufferSize
) PVOID OutBuffer
);
13504 IoWMISetNotificationCallback(
13505 _Inout_ PVOID Object
,
13506 _In_ WMI_NOTIFICATION_CALLBACK Callback
,
13507 _In_opt_ PVOID Context
);
13512 IoWMISetSingleInstance(
13513 _In_ PVOID DataBlockObject
,
13514 _In_ PUNICODE_STRING InstanceName
,
13515 _In_ ULONG Version
,
13516 _In_ ULONG ValueBufferSize
,
13517 _In_reads_bytes_(ValueBufferSize
) PVOID ValueBuffer
);
13522 IoWMISetSingleItem(
13523 _In_ PVOID DataBlockObject
,
13524 _In_ PUNICODE_STRING InstanceName
,
13525 _In_ ULONG DataItemId
,
13526 _In_ ULONG Version
,
13527 _In_ ULONG ValueBufferSize
,
13528 _In_reads_bytes_(ValueBufferSize
) PVOID ValueBuffer
);
13530 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) */
13532 #if (NTDDI_VERSION >= NTDDI_WINXPSP1)
13536 IoValidateDeviceIoControlAccess(
13538 _In_ ULONG RequiredAccess
);
13541 #if (NTDDI_VERSION >= NTDDI_WS03)
13547 _In_ PIO_CSQ_INSERT_IRP_EX CsqInsertIrp
,
13548 _In_ PIO_CSQ_REMOVE_IRP CsqRemoveIrp
,
13549 _In_ PIO_CSQ_PEEK_NEXT_IRP CsqPeekNextIrp
,
13550 _In_ PIO_CSQ_ACQUIRE_LOCK CsqAcquireLock
,
13551 _In_ PIO_CSQ_RELEASE_LOCK CsqReleaseLock
,
13552 _In_ PIO_CSQ_COMPLETE_CANCELED_IRP CsqCompleteCanceledIrp
);
13558 _Inout_ PIO_CSQ Csq
,
13560 _Out_opt_ PIO_CSQ_IRP_CONTEXT Context
,
13561 _In_opt_ PVOID InsertContext
);
13562 #endif /* (NTDDI_VERSION >= NTDDI_WS03) */
13565 #if (NTDDI_VERSION >= NTDDI_VISTA)
13569 IoGetBootDiskInformationLite(
13570 _Outptr_ PBOOTDISK_INFORMATION_LITE
*BootDiskInformation
);
13575 IoCheckShareAccessEx(
13576 _In_ ACCESS_MASK DesiredAccess
,
13577 _In_ ULONG DesiredShareAccess
,
13578 _Inout_ PFILE_OBJECT FileObject
,
13579 _Inout_ PSHARE_ACCESS ShareAccess
,
13580 _In_ BOOLEAN Update
,
13581 _In_ PBOOLEAN WritePermission
);
13586 IoConnectInterruptEx(
13587 _Inout_ PIO_CONNECT_INTERRUPT_PARAMETERS Parameters
);
13592 IoDisconnectInterruptEx(
13593 _In_ PIO_DISCONNECT_INTERRUPT_PARAMETERS Parameters
);
13597 IoWithinStackLimits(
13598 _In_ ULONG_PTR RegionStart
,
13599 _In_ SIZE_T RegionSize
);
13604 IoSetShareAccessEx(
13605 _In_ ACCESS_MASK DesiredAccess
,
13606 _In_ ULONG DesiredShareAccess
,
13607 _Inout_ PFILE_OBJECT FileObject
,
13608 _Out_ PSHARE_ACCESS ShareAccess
,
13609 _In_ PBOOLEAN WritePermission
);
13613 IoSizeofWorkItem(VOID
);
13617 IoInitializeWorkItem(
13618 _In_ PVOID IoObject
,
13619 _Out_ PIO_WORKITEM IoWorkItem
);
13623 IoUninitializeWorkItem(
13624 _Inout_ PIO_WORKITEM IoWorkItem
);
13626 _IRQL_requires_max_(DISPATCH_LEVEL
)
13630 _Inout_ PIO_WORKITEM IoWorkItem
,
13631 _In_ PIO_WORKITEM_ROUTINE_EX WorkerRoutine
,
13632 _In_ WORK_QUEUE_TYPE QueueType
,
13633 _In_opt_ __drv_aliasesMem PVOID Context
);
13637 IoGetIoPriorityHint(
13642 IoSetIoPriorityHint(
13644 _In_ IO_PRIORITY_HINT PriorityHint
);
13648 IoAllocateSfioStreamIdentifier(
13649 _In_ PFILE_OBJECT FileObject
,
13651 _In_ PVOID Signature
,
13652 _Out_ PVOID
*StreamIdentifier
);
13656 IoGetSfioStreamIdentifier(
13657 _In_ PFILE_OBJECT FileObject
,
13658 _In_ PVOID Signature
);
13662 IoFreeSfioStreamIdentifier(
13663 _In_ PFILE_OBJECT FileObject
,
13664 _In_ PVOID Signature
);
13666 _IRQL_requires_max_(DISPATCH_LEVEL
)
13667 _Must_inspect_result_
13671 IoRequestDeviceEjectEx(
13672 _In_ PDEVICE_OBJECT PhysicalDeviceObject
,
13673 _In_opt_ PIO_DEVICE_EJECT_CALLBACK Callback
,
13674 _In_opt_ PVOID Context
,
13675 _In_opt_ PDRIVER_OBJECT DriverObject
);
13677 _IRQL_requires_max_(PASSIVE_LEVEL
)
13678 _Must_inspect_result_
13682 IoSetDevicePropertyData(
13683 _In_ PDEVICE_OBJECT Pdo
,
13684 _In_ CONST DEVPROPKEY
*PropertyKey
,
13687 _In_ DEVPROPTYPE Type
,
13689 _In_opt_ PVOID Data
);
13691 _IRQL_requires_max_(PASSIVE_LEVEL
)
13692 _Must_inspect_result_
13696 IoGetDevicePropertyData(
13697 _In_ PDEVICE_OBJECT Pdo
,
13698 _In_ CONST DEVPROPKEY
*PropertyKey
,
13700 _Reserved_ ULONG Flags
,
13703 _Out_ PULONG RequiredSize
,
13704 _Out_ PDEVPROPTYPE Type
);
13706 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
13708 #define IoCallDriverStackSafeDefault(a, b) IoCallDriver(a, b)
13710 #if (NTDDI_VERSION >= NTDDI_WS08)
13711 _IRQL_requires_max_(PASSIVE_LEVEL
)
13712 _Must_inspect_result_
13716 IoReplacePartitionUnit(
13717 _In_ PDEVICE_OBJECT TargetPdo
,
13718 _In_ PDEVICE_OBJECT SparePdo
,
13722 #if (NTDDI_VERSION >= NTDDI_WIN7)
13727 IoGetAffinityInterrupt(
13728 _In_ PKINTERRUPT InterruptObject
,
13729 _Out_ PGROUP_AFFINITY GroupAffinity
);
13733 IoGetContainerInformation(
13734 _In_ IO_CONTAINER_INFORMATION_CLASS InformationClass
,
13735 _In_opt_ PVOID ContainerObject
,
13736 _Inout_updates_bytes_opt_(BufferLength
) PVOID Buffer
,
13737 _In_ ULONG BufferLength
);
13741 IoRegisterContainerNotification(
13742 _In_ IO_CONTAINER_NOTIFICATION_CLASS NotificationClass
,
13743 _In_ PIO_CONTAINER_NOTIFICATION_FUNCTION CallbackFunction
,
13744 _In_reads_bytes_opt_(NotificationInformationLength
) PVOID NotificationInformation
,
13745 _In_ ULONG NotificationInformationLength
,
13746 _Out_ PVOID CallbackRegistration
);
13750 IoUnregisterContainerNotification(
13751 _In_ PVOID CallbackRegistration
);
13753 _IRQL_requires_max_(PASSIVE_LEVEL
)
13754 __drv_freesMem(Pool
)
13758 IoUnregisterPlugPlayNotificationEx(
13759 _In_ PVOID NotificationEntry
);
13761 _IRQL_requires_max_(PASSIVE_LEVEL
)
13762 _Must_inspect_result_
13766 IoGetDeviceNumaNode(
13767 _In_ PDEVICE_OBJECT Pdo
,
13768 _Out_ PUSHORT NodeNumber
);
13770 #endif /* (NTDDI_VERSION >= NTDDI_WIN7) */
13772 #if defined(_WIN64)
13776 IoWMIDeviceObjectToProviderId(
13777 _In_ PDEVICE_OBJECT DeviceObject
);
13779 #define IoWMIDeviceObjectToProviderId(DeviceObject) ((ULONG)(DeviceObject))
13785 * IN CCHAR StackSize)
13787 #define IoSizeOfIrp(_StackSize) \
13788 ((USHORT) (sizeof(IRP) + ((_StackSize) * (sizeof(IO_STACK_LOCATION)))))
13792 IoSkipCurrentIrpStackLocation(
13795 ASSERT(Irp
->CurrentLocation
<= Irp
->StackCount
);
13796 Irp
->CurrentLocation
++;
13797 #ifdef NONAMELESSUNION
13798 Irp
->Tail
.Overlay
.s
.u
.CurrentStackLocation
++;
13800 Irp
->Tail
.Overlay
.CurrentStackLocation
++;
13806 IoSetNextIrpStackLocation(
13809 ASSERT(Irp
->CurrentLocation
> 0);
13810 Irp
->CurrentLocation
--;
13811 #ifdef NONAMELESSUNION
13812 Irp
->Tail
.Overlay
.s
.u
.CurrentStackLocation
--;
13814 Irp
->Tail
.Overlay
.CurrentStackLocation
--;
13821 IoGetNextIrpStackLocation(
13824 ASSERT(Irp
->CurrentLocation
> 0);
13825 #ifdef NONAMELESSUNION
13826 return ((Irp
)->Tail
.Overlay
.s
.u
.CurrentStackLocation
- 1 );
13828 return ((Irp
)->Tail
.Overlay
.CurrentStackLocation
- 1 );
13832 _IRQL_requires_max_(DISPATCH_LEVEL
)
13835 IoSetCompletionRoutine(
13837 _In_opt_ PIO_COMPLETION_ROUTINE CompletionRoutine
,
13838 _In_opt_ __drv_aliasesMem PVOID Context
,
13839 _In_ BOOLEAN InvokeOnSuccess
,
13840 _In_ BOOLEAN InvokeOnError
,
13841 _In_ BOOLEAN InvokeOnCancel
)
13843 PIO_STACK_LOCATION irpSp
;
13844 ASSERT( (InvokeOnSuccess
|| InvokeOnError
|| InvokeOnCancel
) ? (CompletionRoutine
!= NULL
) : TRUE
);
13845 irpSp
= IoGetNextIrpStackLocation(Irp
);
13846 irpSp
->CompletionRoutine
= CompletionRoutine
;
13847 irpSp
->Context
= Context
;
13848 irpSp
->Control
= 0;
13850 if (InvokeOnSuccess
) {
13851 irpSp
->Control
= SL_INVOKE_ON_SUCCESS
;
13854 if (InvokeOnError
) {
13855 irpSp
->Control
|= SL_INVOKE_ON_ERROR
;
13858 if (InvokeOnCancel
) {
13859 irpSp
->Control
|= SL_INVOKE_ON_CANCEL
;
13863 _IRQL_requires_max_(DISPATCH_LEVEL
)
13867 IoSetCancelRoutine(
13869 _In_opt_ PDRIVER_CANCEL CancelRoutine
)
13871 return (PDRIVER_CANCEL
)(ULONG_PTR
) InterlockedExchangePointer((PVOID
*)&(Irp
)->CancelRoutine
, (PVOID
)(ULONG_PTR
)(CancelRoutine
));
13877 _Inout_ PDEVICE_OBJECT DeviceObject
,
13879 _In_opt_ __drv_aliasesMem PVOID Context
)
13881 KeInsertQueueDpc(&DeviceObject
->Dpc
, Irp
, Context
);
13886 * IoReleaseRemoveLock(
13887 * IN PIO_REMOVE_LOCK RemoveLock,
13890 #define IoReleaseRemoveLock(_RemoveLock, \
13892 IoReleaseRemoveLockEx(_RemoveLock, _Tag, sizeof(IO_REMOVE_LOCK))
13896 * IoReleaseRemoveLockAndWait(
13897 * IN PIO_REMOVE_LOCK RemoveLock,
13900 #define IoReleaseRemoveLockAndWait(_RemoveLock, \
13902 IoReleaseRemoveLockAndWaitEx(_RemoveLock, _Tag, sizeof(IO_REMOVE_LOCK))
13904 #if defined(_WIN64)
13905 _IRQL_requires_max_(DISPATCH_LEVEL
)
13909 _In_opt_ PIRP Irp
);
13912 #define PLUGPLAY_REGKEY_DEVICE 1
13913 #define PLUGPLAY_REGKEY_DRIVER 2
13914 #define PLUGPLAY_REGKEY_CURRENT_HWPROFILE 4
13919 IoGetCurrentIrpStackLocation(
13922 ASSERT(Irp
->CurrentLocation
<= Irp
->StackCount
+ 1);
13923 #ifdef NONAMELESSUNION
13924 return Irp
->Tail
.Overlay
.s
.u
.CurrentStackLocation
;
13926 return Irp
->Tail
.Overlay
.CurrentStackLocation
;
13935 IoGetCurrentIrpStackLocation((Irp
))->Control
|= SL_PENDING_RETURNED
;
13940 * IoIsErrorUserInduced(
13941 * IN NTSTATUS Status);
13943 #define IoIsErrorUserInduced(Status) \
13944 ((BOOLEAN)(((Status) == STATUS_DEVICE_NOT_READY) || \
13945 ((Status) == STATUS_IO_TIMEOUT) || \
13946 ((Status) == STATUS_MEDIA_WRITE_PROTECTED) || \
13947 ((Status) == STATUS_NO_MEDIA_IN_DEVICE) || \
13948 ((Status) == STATUS_VERIFY_REQUIRED) || \
13949 ((Status) == STATUS_UNRECOGNIZED_MEDIA) || \
13950 ((Status) == STATUS_WRONG_VOLUME)))
13953 * IoInitializeRemoveLock(
13954 * IN PIO_REMOVE_LOCK Lock,
13955 * IN ULONG AllocateTag,
13956 * IN ULONG MaxLockedMinutes,
13957 * IN ULONG HighWatermark)
13959 #define IoInitializeRemoveLock( \
13960 Lock, AllocateTag, MaxLockedMinutes, HighWatermark) \
13961 IoInitializeRemoveLockEx(Lock, AllocateTag, MaxLockedMinutes, \
13962 HighWatermark, sizeof(IO_REMOVE_LOCK))
13966 IoInitializeDpcRequest(
13967 _In_ PDEVICE_OBJECT DeviceObject
,
13968 _In_ PIO_DPC_ROUTINE DpcRoutine
)
13971 #pragma warning(push)
13972 #pragma warning(disable:28024)
13974 KeInitializeDpc(&DeviceObject
->Dpc
,
13975 (PKDEFERRED_ROUTINE
) DpcRoutine
,
13978 #pragma warning(pop)
13982 #define DEVICE_INTERFACE_INCLUDE_NONACTIVE 0x00000001
13986 * IoGetFunctionCodeFromCtlCode(
13987 * IN ULONG ControlCode)
13989 #define IoGetFunctionCodeFromCtlCode(_ControlCode) \
13990 (((_ControlCode) >> 2) & 0x00000FFF)
13994 IoCopyCurrentIrpStackLocationToNext(
13997 PIO_STACK_LOCATION irpSp
;
13998 PIO_STACK_LOCATION nextIrpSp
;
13999 irpSp
= IoGetCurrentIrpStackLocation(Irp
);
14000 nextIrpSp
= IoGetNextIrpStackLocation(Irp
);
14001 RtlCopyMemory(nextIrpSp
, irpSp
, FIELD_OFFSET(IO_STACK_LOCATION
, CompletionRoutine
));
14002 nextIrpSp
->Control
= 0;
14005 _IRQL_requires_max_(APC_LEVEL
)
14010 _Out_ PULONG_PTR LowLimit
,
14011 _Out_ PULONG_PTR HighLimit
);
14013 _IRQL_requires_max_(APC_LEVEL
)
14016 IoGetRemainingStackSize(VOID
)
14018 ULONG_PTR End
, Begin
;
14021 IoGetStackLimits(&Begin
, &End
);
14022 Result
= (ULONG_PTR
)(&End
) - Begin
;
14026 #if (NTDDI_VERSION >= NTDDI_WS03)
14029 IoInitializeThreadedDpcRequest(
14030 _In_ PDEVICE_OBJECT DeviceObject
,
14031 _In_ PIO_DPC_ROUTINE DpcRoutine
)
14034 #pragma warning(push)
14035 #pragma warning(disable:28024)
14036 #pragma warning(disable:28128)
14038 KeInitializeThreadedDpc(&DeviceObject
->Dpc
,
14039 (PKDEFERRED_ROUTINE
) DpcRoutine
,
14042 #pragma warning(pop)
14047 /******************************************************************************
14048 * Power Management Support Functions *
14049 ******************************************************************************/
14051 #define PoSetDeviceBusy(IdlePointer) ((void)(*(IdlePointer) = 0))
14053 #if (NTDDI_VERSION >= NTDDI_WIN2K)
14055 _IRQL_requires_max_(DISPATCH_LEVEL
)
14060 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
14061 _Inout_ __drv_aliasesMem
struct _IRP
*Irp
);
14063 _IRQL_requires_max_(APC_LEVEL
)
14067 PoRegisterDeviceForIdleDetection(
14068 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
14069 _In_ ULONG ConservationIdleTime
,
14070 _In_ ULONG PerformanceIdleTime
,
14071 _In_ DEVICE_POWER_STATE State
);
14073 _IRQL_requires_max_(APC_LEVEL
)
14077 PoRegisterSystemState(
14078 _Inout_opt_ PVOID StateHandle
,
14079 _In_ EXECUTION_STATE Flags
);
14081 _IRQL_requires_max_(DISPATCH_LEVEL
)
14086 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
14087 _In_ UCHAR MinorFunction
,
14088 _In_ POWER_STATE PowerState
,
14089 _In_opt_ PREQUEST_POWER_COMPLETE CompletionFunction
,
14090 _In_opt_ __drv_aliasesMem PVOID Context
,
14091 _Outptr_opt_
struct _IRP
**Irp
);
14093 _IRQL_requires_max_(DISPATCH_LEVEL
)
14098 _In_
struct _DEVICE_OBJECT
*DeviceObject
,
14099 _In_ POWER_STATE_TYPE Type
,
14100 _In_ POWER_STATE State
);
14102 _IRQL_requires_max_(DISPATCH_LEVEL
)
14107 _In_ EXECUTION_STATE Flags
);
14109 _IRQL_requires_max_(DISPATCH_LEVEL
)
14113 PoStartNextPowerIrp(
14114 _Inout_
struct _IRP
*Irp
);
14116 _IRQL_requires_max_(APC_LEVEL
)
14120 PoUnregisterSystemState(
14121 _Inout_ PVOID StateHandle
);
14126 PoRequestShutdownEvent(
14129 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
14131 #if (NTDDI_VERSION >= NTDDI_VISTA)
14133 _IRQL_requires_max_(DISPATCH_LEVEL
)
14138 _Inout_
struct _IRP
*Irp
);
14140 _IRQL_requires_max_(DISPATCH_LEVEL
)
14145 _In_
struct _IRP
*Irp
);
14147 _IRQL_requires_max_(APC_LEVEL
)
14151 PoRegisterPowerSettingCallback(
14152 _In_opt_ PDEVICE_OBJECT DeviceObject
,
14153 _In_ LPCGUID SettingGuid
,
14154 _In_ PPOWER_SETTING_CALLBACK Callback
,
14155 _In_opt_ PVOID Context
,
14156 _Outptr_opt_ PVOID
*Handle
);
14158 _IRQL_requires_max_(APC_LEVEL
)
14162 PoUnregisterPowerSettingCallback(
14163 _Inout_ PVOID Handle
);
14165 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
14167 #if (NTDDI_VERSION >= NTDDI_VISTASP1)
14172 _Inout_ PULONG IdlePointer
);
14173 #endif /* (NTDDI_VERSION >= NTDDI_VISTASP1) */
14175 #if (NTDDI_VERSION >= NTDDI_WIN7)
14181 _Inout_ PULONG IdlePointer
);
14187 _Inout_ PULONG IdlePointer
);
14189 _IRQL_requires_max_(DISPATCH_LEVEL
)
14193 PoQueryWatchdogTime(
14194 _In_ PDEVICE_OBJECT Pdo
,
14195 _Out_ PULONG SecondsRemaining
);
14197 _IRQL_requires_max_(APC_LEVEL
)
14201 PoDeletePowerRequest(
14202 _Inout_ PVOID PowerRequest
);
14204 _IRQL_requires_max_(DISPATCH_LEVEL
)
14209 _Inout_ PVOID PowerRequest
,
14210 _In_ POWER_REQUEST_TYPE Type
);
14212 _IRQL_requires_max_(DISPATCH_LEVEL
)
14216 PoClearPowerRequest(
14217 _Inout_ PVOID PowerRequest
,
14218 _In_ POWER_REQUEST_TYPE Type
);
14220 _IRQL_requires_max_(APC_LEVEL
)
14224 PoCreatePowerRequest(
14225 _Outptr_ PVOID
*PowerRequest
,
14226 _In_ PDEVICE_OBJECT DeviceObject
,
14227 _In_opt_ PCOUNTED_REASON_CONTEXT Context
);
14229 #endif /* (NTDDI_VERSION >= NTDDI_WIN7) */
14231 /******************************************************************************
14232 * Executive Functions *
14233 ******************************************************************************/
14235 #define ExInterlockedIncrementLong(Addend,Lock) Exfi386InterlockedIncrementLong(Addend)
14236 #define ExInterlockedDecrementLong(Addend,Lock) Exfi386InterlockedDecrementLong(Addend)
14237 #define ExInterlockedExchangeUlong(Target, Value, Lock) Exfi386InterlockedExchangeUlong(Target, Value)
14239 #define ExAcquireSpinLock(Lock, OldIrql) KeAcquireSpinLock((Lock), (OldIrql))
14240 #define ExReleaseSpinLock(Lock, OldIrql) KeReleaseSpinLock((Lock), (OldIrql))
14241 #define ExAcquireSpinLockAtDpcLevel(Lock) KeAcquireSpinLockAtDpcLevel(Lock)
14242 #define ExReleaseSpinLockFromDpcLevel(Lock) KeReleaseSpinLockFromDpcLevel(Lock)
14244 #define ExInitializeSListHead InitializeSListHead
14246 #if defined(_NTHAL_) && defined(_X86_)
14251 ExiAcquireFastMutex(
14252 IN OUT PFAST_MUTEX FastMutex
);
14257 ExiReleaseFastMutex(
14258 IN OUT PFAST_MUTEX FastMutex
);
14263 ExiTryToAcquireFastMutex(
14264 IN OUT PFAST_MUTEX FastMutex
);
14266 #define ExAcquireFastMutex ExiAcquireFastMutex
14267 #define ExReleaseFastMutex ExiReleaseFastMutex
14268 #define ExTryToAcquireFastMutex ExiTryToAcquireFastMutex
14272 #if (NTDDI_VERSION >= NTDDI_WIN2K)
14274 _IRQL_raises_(APC_LEVEL
)
14275 _IRQL_saves_global_(OldIrql
, FastMutex
)
14279 ExAcquireFastMutex(
14280 _Inout_
_Requires_lock_not_held_(*_Curr_
) _Acquires_lock_(*_Curr_
)
14281 PFAST_MUTEX FastMutex
);
14283 _IRQL_requires_(APC_LEVEL
)
14284 _IRQL_restores_global_(OldIrql
, FastMutex
)
14288 ExReleaseFastMutex(
14289 _Inout_
_Requires_lock_held_(*_Curr_
) _Releases_lock_(*_Curr_
)
14290 PFAST_MUTEX FastMutex
);
14292 _Must_inspect_result_
14293 _Success_(return!=FALSE
)
14294 _IRQL_raises_(APC_LEVEL
)
14295 _IRQL_saves_global_(OldIrql
, FastMutex
)
14299 ExTryToAcquireFastMutex(
14300 _Inout_
_Requires_lock_not_held_(*_Curr_
) _Acquires_lock_(*_Curr_
)
14301 PFAST_MUTEX FastMutex
);
14303 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
14305 #endif /* defined(_NTHAL_) && defined(_X86_) */
14308 #define ExInterlockedAddUlong ExfInterlockedAddUlong
14309 #define ExInterlockedInsertHeadList ExfInterlockedInsertHeadList
14310 #define ExInterlockedInsertTailList ExfInterlockedInsertTailList
14311 #define ExInterlockedRemoveHeadList ExfInterlockedRemoveHeadList
14312 #define ExInterlockedPopEntryList ExfInterlockedPopEntryList
14313 #define ExInterlockedPushEntryList ExfInterlockedPushEntryList
14314 #endif /* defined(_X86_) */
14316 #if defined(_WIN64)
14318 #if defined(_NTDRIVER_) || defined(_NTDDK_) || defined(_NTIFS_) || \
14319 defined(_NTHAL_) || defined(_NTOSP_)
14322 ExQueryDepthSList(_In_ PSLIST_HEADER ListHead
);
14326 ExQueryDepthSList(_In_ PSLIST_HEADER ListHead
)
14328 return (USHORT
)(ListHead
->Alignment
& 0xffff);
14334 ExpInterlockedFlushSList(
14335 PSLIST_HEADER ListHead
);
14339 ExpInterlockedPopEntrySList(
14340 _Inout_ PSLIST_HEADER ListHead
);
14344 ExpInterlockedPushEntrySList(
14345 _Inout_ PSLIST_HEADER ListHead
,
14346 _Inout_ __drv_aliasesMem PSLIST_ENTRY ListEntry
);
14348 #define ExInterlockedFlushSList(Head) \
14349 ExpInterlockedFlushSList(Head)
14350 #define ExInterlockedPopEntrySList(Head, Lock) \
14351 ExpInterlockedPopEntrySList(Head)
14352 #define ExInterlockedPushEntrySList(Head, Entry, Lock) \
14353 ExpInterlockedPushEntrySList(Head, Entry)
14355 #else /* !defined(_WIN64) */
14357 #ifdef NONAMELESSUNION
14358 #define ExQueryDepthSList(listhead) (listhead)->s.Depth
14360 #define ExQueryDepthSList(listhead) (listhead)->Depth
14366 ExInterlockedFlushSList(
14367 _Inout_ PSLIST_HEADER ListHead
);
14369 #endif /* !defined(_WIN64) */
14371 #if defined(_WIN2K_COMPAT_SLIST_USAGE) && defined(_X86_)
14376 ExInterlockedPopEntrySList(
14377 _Inout_ PSLIST_HEADER ListHead
,
14378 _Inout_
_Requires_lock_not_held_(*_Curr_
) PKSPIN_LOCK Lock
);
14383 ExInterlockedPushEntrySList(
14384 _Inout_ PSLIST_HEADER ListHead
,
14385 _Inout_ __drv_aliasesMem PSINGLE_LIST_ENTRY ListEntry
,
14386 _Inout_
_Requires_lock_not_held_(*_Curr_
) PKSPIN_LOCK Lock
);
14388 _IRQL_requires_max_(APC_LEVEL
)
14392 ExAllocateFromPagedLookasideList(
14393 _Inout_ PPAGED_LOOKASIDE_LIST Lookaside
);
14395 _IRQL_requires_max_(APC_LEVEL
)
14399 ExFreeToPagedLookasideList(
14400 _Inout_ PPAGED_LOOKASIDE_LIST Lookaside
,
14403 #else /* !_WIN2K_COMPAT_SLIST_USAGE */
14405 #if !defined(_WIN64)
14406 #define ExInterlockedPopEntrySList(_ListHead, _Lock) \
14407 InterlockedPopEntrySList(_ListHead)
14408 #define ExInterlockedPushEntrySList(_ListHead, _ListEntry, _Lock) \
14409 InterlockedPushEntrySList(_ListHead, _ListEntry)
14412 _IRQL_requires_max_(APC_LEVEL
)
14415 ExAllocateFromPagedLookasideList(
14416 _Inout_ PPAGED_LOOKASIDE_LIST Lookaside
)
14420 Lookaside
->L
.TotalAllocates
++;
14421 #ifdef NONAMELESSUNION
14422 Entry
= InterlockedPopEntrySList(&Lookaside
->L
.u
.ListHead
);
14423 if (Entry
== NULL
) {
14424 Lookaside
->L
.u2
.AllocateMisses
++;
14425 Entry
= (Lookaside
->L
.u4
.Allocate
)(Lookaside
->L
.Type
,
14429 #else /* NONAMELESSUNION */
14430 Entry
= InterlockedPopEntrySList(&Lookaside
->L
.ListHead
);
14431 if (Entry
== NULL
) {
14432 Lookaside
->L
.AllocateMisses
++;
14433 Entry
= (Lookaside
->L
.Allocate
)(Lookaside
->L
.Type
,
14437 #endif /* NONAMELESSUNION */
14441 _IRQL_requires_max_(APC_LEVEL
)
14444 ExFreeToPagedLookasideList(
14445 _Inout_ PPAGED_LOOKASIDE_LIST Lookaside
,
14448 Lookaside
->L
.TotalFrees
++;
14449 #ifdef NONAMELESSUNION
14450 if (ExQueryDepthSList(&Lookaside
->L
.u
.ListHead
) >= Lookaside
->L
.Depth
) {
14451 Lookaside
->L
.u3
.FreeMisses
++;
14452 (Lookaside
->L
.u5
.Free
)(Entry
);
14454 InterlockedPushEntrySList(&Lookaside
->L
.u
.ListHead
, (PSLIST_ENTRY
)Entry
);
14456 #else /* NONAMELESSUNION */
14457 if (ExQueryDepthSList(&Lookaside
->L
.ListHead
) >= Lookaside
->L
.Depth
) {
14458 Lookaside
->L
.FreeMisses
++;
14459 (Lookaside
->L
.Free
)(Entry
);
14461 InterlockedPushEntrySList(&Lookaside
->L
.ListHead
, (PSLIST_ENTRY
)Entry
);
14463 #endif /* NONAMELESSUNION */
14466 #endif /* _WIN2K_COMPAT_SLIST_USAGE */
14469 /* ERESOURCE_THREAD
14470 * ExGetCurrentResourceThread(
14473 #define ExGetCurrentResourceThread() ((ULONG_PTR)PsGetCurrentThread())
14475 #define ExReleaseResource(R) (ExReleaseResourceLite(R))
14478 * ExInitializeWorkItem(
14479 * IN PWORK_QUEUE_ITEM Item,
14480 * IN PWORKER_THREAD_ROUTINE Routine,
14481 * IN PVOID Context)
14483 #define ExInitializeWorkItem(Item, Routine, Context) \
14485 (Item)->WorkerRoutine = Routine; \
14486 (Item)->Parameter = Context; \
14487 (Item)->List.Flink = NULL; \
14492 ExInitializeFastMutex(
14493 _Out_ PFAST_MUTEX FastMutex
)
14495 FastMutex
->Count
= FM_LOCK_BIT
;
14496 FastMutex
->Owner
= NULL
;
14497 FastMutex
->Contention
= 0;
14498 KeInitializeEvent(&FastMutex
->Event
, SynchronizationEvent
, FALSE
);
14503 #if (NTDDI_VERSION >= NTDDI_WIN2K)
14504 _IRQL_requires_max_(APC_LEVEL
)
14505 _Requires_lock_held_(_Global_critical_region_
)
14509 ExAcquireFastMutexUnsafe(
14510 _Inout_
_Requires_lock_not_held_(*_Curr_
) _Acquires_lock_(*_Curr_
)
14511 PFAST_MUTEX FastMutex
);
14513 _IRQL_requires_max_(APC_LEVEL
)
14514 _Requires_lock_held_(_Global_critical_region_
)
14518 ExReleaseFastMutexUnsafe(
14519 _Inout_
_Requires_lock_held_(*_Curr_
) _Releases_lock_(*_Curr_
)
14520 PFAST_MUTEX FastMutex
);
14522 _Requires_lock_held_(_Global_critical_region_
)
14523 _Requires_lock_not_held_(*Resource
)
14524 _When_(Wait
!=0, _Acquires_exclusive_lock_(*Resource
))
14525 _IRQL_requires_max_(APC_LEVEL
)
14526 _When_(Wait
!=0, _Post_satisfies_(return == 1))
14527 _When_(Wait
==0, _Post_satisfies_(return == 0 || return == 1) _Must_inspect_result_
)
14531 ExAcquireResourceExclusiveLite(
14532 _Inout_ PERESOURCE Resource
,
14533 _In_ _Literal_ BOOLEAN Wait
);
14535 _IRQL_requires_max_(APC_LEVEL
)
14536 _Requires_lock_held_(_Global_critical_region_
)
14537 _When_(Wait
!=0, _Post_satisfies_(return == 1))
14538 _When_(Wait
==0, _Post_satisfies_(return == 0 || return == 1) _Must_inspect_result_
)
14542 ExAcquireResourceSharedLite(
14543 _Inout_
_Requires_lock_not_held_(*_Curr_
)
14544 _When_(return!=0, _Acquires_shared_lock_(*_Curr_
))
14545 PERESOURCE Resource
,
14546 _In_ BOOLEAN Wait
);
14548 _IRQL_requires_max_(APC_LEVEL
)
14549 _Requires_lock_held_(_Global_critical_region_
)
14550 _When_(Wait
!=0, _Post_satisfies_(return == 1))
14551 _When_(Wait
==0, _Post_satisfies_(return == 0 || return == 1) _Must_inspect_result_
)
14555 ExAcquireSharedStarveExclusive(
14556 _Inout_
_Requires_lock_not_held_(*_Curr_
)
14557 _When_(return!=0, _Acquires_shared_lock_(*_Curr_
))
14558 PERESOURCE Resource
,
14559 _In_ BOOLEAN Wait
);
14561 _IRQL_requires_max_(APC_LEVEL
)
14562 _Requires_lock_held_(_Global_critical_region_
)
14563 _When_(Wait
!=0, _Post_satisfies_(return == 1))
14564 _When_(Wait
==0, _Post_satisfies_(return == 0 || return == 1) _Must_inspect_result_
)
14568 ExAcquireSharedWaitForExclusive(
14569 _Inout_
_Requires_lock_not_held_(*_Curr_
)
14570 _When_(return!=0, _Acquires_lock_(*_Curr_
))
14571 PERESOURCE Resource
,
14572 _In_ BOOLEAN Wait
);
14574 __drv_preferredFunction("ExAllocatePoolWithTag",
14575 "No tag interferes with debugging.")
14576 __drv_allocatesMem(Mem
)
14577 _When_((PoolType
& PagedPool
) != 0, _IRQL_requires_max_(APC_LEVEL
))
14578 _When_((PoolType
& PagedPool
) == 0, _IRQL_requires_max_(DISPATCH_LEVEL
))
14579 _When_((PoolType
& NonPagedPoolMustSucceed
) != 0,
14580 __drv_reportError("Must succeed pool allocations are forbidden. "
14581 "Allocation failures cause a system crash"))
14582 _When_((PoolType
& (NonPagedPoolMustSucceed
|
14583 POOL_RAISE_IF_ALLOCATION_FAILURE
)) == 0,
14584 _Post_maybenull_ _Must_inspect_result_
)
14585 _When_((PoolType
& (NonPagedPoolMustSucceed
|
14586 POOL_RAISE_IF_ALLOCATION_FAILURE
)) != 0,
14588 _Post_writable_byte_size_(NumberOfBytes
)
14593 __drv_strictTypeMatch(__drv_typeExpr
) _In_ POOL_TYPE PoolType
,
14594 _In_ SIZE_T NumberOfBytes
);
14596 __drv_preferredFunction("ExAllocatePoolWithQuotaTag",
14597 "No tag interferes with debugging.")
14598 __drv_allocatesMem(Mem
)
14599 _When_((PoolType
& PagedPool
) != 0, _IRQL_requires_max_(APC_LEVEL
))
14600 _When_((PoolType
& PagedPool
) == 0, _IRQL_requires_max_(DISPATCH_LEVEL
))
14601 _When_((PoolType
& NonPagedPoolMustSucceed
) != 0,
14602 __drv_reportError("Must succeed pool allocations are forbidden. "
14603 "Allocation failures cause a system crash"))
14604 _When_((PoolType
& POOL_QUOTA_FAIL_INSTEAD_OF_RAISE
) != 0,
14605 _Post_maybenull_ _Must_inspect_result_
)
14606 _When_((PoolType
& POOL_QUOTA_FAIL_INSTEAD_OF_RAISE
) == 0, _Post_notnull_
)
14607 _Post_writable_byte_size_(NumberOfBytes
)
14611 ExAllocatePoolWithQuota(
14612 __drv_strictTypeMatch(__drv_typeExpr
) _In_ POOL_TYPE PoolType
,
14613 _In_ SIZE_T NumberOfBytes
);
14615 __drv_allocatesMem(Mem
)
14616 _When_((PoolType
& PagedPool
) != 0, _IRQL_requires_max_(APC_LEVEL
))
14617 _When_((PoolType
& PagedPool
) == 0, _IRQL_requires_max_(DISPATCH_LEVEL
))
14618 _When_((PoolType
& NonPagedPoolMustSucceed
) != 0,
14619 __drv_reportError("Must succeed pool allocations are forbidden. "
14620 "Allocation failures cause a system crash"))
14621 _When_((PoolType
& POOL_QUOTA_FAIL_INSTEAD_OF_RAISE
) != 0,
14622 _Post_maybenull_ _Must_inspect_result_
)
14623 _When_((PoolType
& POOL_QUOTA_FAIL_INSTEAD_OF_RAISE
) == 0, _Post_notnull_
)
14624 _Post_writable_byte_size_(NumberOfBytes
)
14628 ExAllocatePoolWithQuotaTag(
14629 _In_
__drv_strictTypeMatch(__drv_typeExpr
) POOL_TYPE PoolType
,
14630 _In_ SIZE_T NumberOfBytes
,
14633 #ifndef POOL_TAGGING
14634 #define ExAllocatePoolWithQuotaTag(a,b,c) ExAllocatePoolWithQuota(a,b)
14637 __drv_allocatesMem(Mem
)
14638 _When_((PoolType
& PagedPool
) != 0, _IRQL_requires_max_(APC_LEVEL
))
14639 _When_((PoolType
& PagedPool
) == 0, _IRQL_requires_max_(DISPATCH_LEVEL
))
14640 _When_((PoolType
& NonPagedPoolMustSucceed
) != 0,
14641 __drv_reportError("Must succeed pool allocations are forbidden. "
14642 "Allocation failures cause a system crash"))
14643 _When_((PoolType
& (NonPagedPoolMustSucceed
| POOL_RAISE_IF_ALLOCATION_FAILURE
)) == 0,
14644 _Post_maybenull_ _Must_inspect_result_
)
14645 _When_((PoolType
& (NonPagedPoolMustSucceed
| POOL_RAISE_IF_ALLOCATION_FAILURE
)) != 0,
14647 _Post_writable_byte_size_(NumberOfBytes
)
14648 _Function_class_(ALLOCATE_FUNCTION
)
14652 ExAllocatePoolWithTag(
14653 _In_
__drv_strictTypeMatch(__drv_typeExpr
) POOL_TYPE PoolType
,
14654 _In_ SIZE_T NumberOfBytes
,
14657 #ifndef POOL_TAGGING
14658 #define ExAllocatePoolWithTag(a,b,c) ExAllocatePool(a,b)
14661 __drv_allocatesMem(Mem
)
14662 _When_((PoolType
& PagedPool
) != 0, _IRQL_requires_max_(APC_LEVEL
))
14663 _When_((PoolType
& PagedPool
) == 0, _IRQL_requires_max_(DISPATCH_LEVEL
))
14664 _When_((PoolType
& NonPagedPoolMustSucceed
) != 0,
14665 __drv_reportError("Must succeed pool allocations are forbidden. "
14666 "Allocation failures cause a system crash"))
14667 _When_((PoolType
& (NonPagedPoolMustSucceed
| POOL_RAISE_IF_ALLOCATION_FAILURE
)) == 0,
14668 _Post_maybenull_ _Must_inspect_result_
)
14669 _When_((PoolType
& (NonPagedPoolMustSucceed
| POOL_RAISE_IF_ALLOCATION_FAILURE
)) != 0,
14671 _Post_writable_byte_size_(NumberOfBytes
)
14675 ExAllocatePoolWithTagPriority(
14676 _In_
__drv_strictTypeMatch(__drv_typeCond
) POOL_TYPE PoolType
,
14677 _In_ SIZE_T NumberOfBytes
,
14679 _In_
__drv_strictTypeMatch(__drv_typeExpr
) EX_POOL_PRIORITY Priority
);
14681 _IRQL_requires_max_(DISPATCH_LEVEL
)
14685 ExConvertExclusiveToSharedLite(
14686 _Inout_
_Requires_lock_held_(*_Curr_
) PERESOURCE Resource
);
14688 _IRQL_requires_max_(APC_LEVEL
)
14693 _Outptr_ PCALLBACK_OBJECT
*CallbackObject
,
14694 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
14695 _In_ BOOLEAN Create
,
14696 _In_ BOOLEAN AllowMultipleCallbacks
);
14701 ExDeleteNPagedLookasideList(
14702 _Inout_ PNPAGED_LOOKASIDE_LIST Lookaside
);
14704 _IRQL_requires_max_(APC_LEVEL
)
14708 ExDeletePagedLookasideList(
14709 _Inout_ PPAGED_LOOKASIDE_LIST Lookaside
);
14711 _IRQL_requires_max_(DISPATCH_LEVEL
)
14715 ExDeleteResourceLite(
14716 _Inout_ PERESOURCE Resource
);
14718 _IRQL_requires_max_(DISPATCH_LEVEL
)
14719 _Function_class_(FREE_FUNCTION
)
14724 _In_
__drv_freesMem(Mem
) PVOID P
);
14726 _IRQL_requires_max_(DISPATCH_LEVEL
)
14731 _In_
__drv_freesMem(Mem
) PVOID P
,
14734 _IRQL_requires_max_(DISPATCH_LEVEL
)
14738 ExGetExclusiveWaiterCount(
14739 _In_ PERESOURCE Resource
);
14741 _IRQL_requires_max_(DISPATCH_LEVEL
)
14745 ExGetPreviousMode(VOID
);
14747 _IRQL_requires_max_(DISPATCH_LEVEL
)
14751 ExGetSharedWaiterCount(
14752 _In_ PERESOURCE Resource
);
14754 _IRQL_requires_max_(DISPATCH_LEVEL
)
14758 ExInitializeNPagedLookasideList(
14759 _Out_ PNPAGED_LOOKASIDE_LIST Lookaside
,
14760 _In_opt_ PALLOCATE_FUNCTION Allocate
,
14761 _In_opt_ PFREE_FUNCTION Free
,
14765 _In_ USHORT Depth
);
14767 _IRQL_requires_max_(APC_LEVEL
)
14771 ExInitializePagedLookasideList(
14772 _Out_ PPAGED_LOOKASIDE_LIST Lookaside
,
14773 _In_opt_ PALLOCATE_FUNCTION Allocate
,
14774 _In_opt_ PFREE_FUNCTION Free
,
14778 _In_ USHORT Depth
);
14780 _IRQL_requires_max_(DISPATCH_LEVEL
)
14784 ExInitializeResourceLite(
14785 _Out_ PERESOURCE Resource
);
14790 ExInterlockedAddLargeInteger(
14791 _Inout_ PLARGE_INTEGER Addend
,
14792 _In_ LARGE_INTEGER Increment
,
14793 _Inout_
_Requires_lock_not_held_(*_Curr_
) PKSPIN_LOCK Lock
);
14795 #if defined(_WIN64)
14796 #define ExInterlockedAddLargeStatistic(Addend, Increment) \
14797 (VOID)InterlockedAdd64(&(Addend)->QuadPart, Increment)
14799 #define ExInterlockedAddLargeStatistic(Addend, Increment) \
14800 _InterlockedAddLargeStatistic((PLONGLONG)&(Addend)->QuadPart, Increment)
14806 ExInterlockedAddUlong(
14807 _Inout_ PULONG Addend
,
14808 _In_ ULONG Increment
,
14809 _Inout_
_Requires_lock_not_held_(*_Curr_
) PKSPIN_LOCK Lock
);
14811 #if defined(_AMD64_) || defined(_IA64_)
14813 #define ExInterlockedCompareExchange64(Destination, Exchange, Comperand, Lock) \
14814 InterlockedCompareExchange64(Destination, *(Exchange), *(Comperand))
14816 #elif defined(_X86_)
14821 ExfInterlockedCompareExchange64(
14822 _Inout_ _Interlocked_operand_ LONGLONG
volatile *Destination
,
14823 _In_ PLONGLONG Exchange
,
14824 _In_ PLONGLONG Comperand
);
14826 #define ExInterlockedCompareExchange64(Destination, Exchange, Comperand, Lock) \
14827 ExfInterlockedCompareExchange64(Destination, Exchange, Comperand)
14834 ExInterlockedCompareExchange64(
14835 IN OUT LONGLONG
volatile *Destination
,
14836 IN PLONGLONG Exchange
,
14837 IN PLONGLONG Comparand
,
14838 IN PKSPIN_LOCK Lock
);
14840 #endif /* defined(_AMD64_) || defined(_IA64_) */
14845 ExInterlockedInsertHeadList(
14846 _Inout_ PLIST_ENTRY ListHead
,
14847 _Inout_ __drv_aliasesMem PLIST_ENTRY ListEntry
,
14848 _Inout_
_Requires_lock_not_held_(*_Curr_
) PKSPIN_LOCK Lock
);
14853 ExInterlockedInsertTailList(
14854 _Inout_ PLIST_ENTRY ListHead
,
14855 _Inout_ __drv_aliasesMem PLIST_ENTRY ListEntry
,
14856 _Inout_
_Requires_lock_not_held_(*_Curr_
) PKSPIN_LOCK Lock
);
14861 ExInterlockedPopEntryList(
14862 _Inout_ PSINGLE_LIST_ENTRY ListHead
,
14863 _Inout_
_Requires_lock_not_held_(*_Curr_
) PKSPIN_LOCK Lock
);
14868 ExInterlockedPushEntryList(
14869 _Inout_ PSINGLE_LIST_ENTRY ListHead
,
14870 _Inout_ __drv_aliasesMem PSINGLE_LIST_ENTRY ListEntry
,
14871 _Inout_
_Requires_lock_not_held_(*_Curr_
) PKSPIN_LOCK Lock
);
14876 ExInterlockedRemoveHeadList(
14877 _Inout_ PLIST_ENTRY ListHead
,
14878 _Inout_
_Requires_lock_not_held_(*_Curr_
) PKSPIN_LOCK Lock
);
14880 _IRQL_requires_max_(PASSIVE_LEVEL
)
14884 ExIsProcessorFeaturePresent(
14885 _In_ ULONG ProcessorFeature
);
14887 _IRQL_requires_max_(DISPATCH_LEVEL
)
14891 ExIsResourceAcquiredExclusiveLite(
14892 _In_ PERESOURCE Resource
);
14894 _IRQL_requires_max_(DISPATCH_LEVEL
)
14898 ExIsResourceAcquiredSharedLite(
14899 _In_ PERESOURCE Resource
);
14901 #define ExIsResourceAcquiredLite ExIsResourceAcquiredSharedLite
14906 ExLocalTimeToSystemTime(
14907 _In_ PLARGE_INTEGER LocalTime
,
14908 _Out_ PLARGE_INTEGER SystemTime
);
14910 _IRQL_requires_max_(DISPATCH_LEVEL
)
14915 _In_ PCALLBACK_OBJECT CallbackObject
,
14916 _In_opt_ PVOID Argument1
,
14917 _In_opt_ PVOID Argument2
);
14919 _IRQL_requires_max_(DISPATCH_LEVEL
)
14924 _Inout_ __drv_aliasesMem PWORK_QUEUE_ITEM WorkItem
,
14925 __drv_strictTypeMatch(__drv_typeExpr
) _In_ WORK_QUEUE_TYPE QueueType
);
14927 _IRQL_requires_max_(APC_LEVEL
)
14933 _In_ NTSTATUS Status
);
14935 _IRQL_requires_max_(APC_LEVEL
)
14939 ExRegisterCallback(
14940 _Inout_ PCALLBACK_OBJECT CallbackObject
,
14941 _In_ PCALLBACK_FUNCTION CallbackFunction
,
14942 _In_opt_ PVOID CallbackContext
);
14944 _IRQL_requires_max_(DISPATCH_LEVEL
)
14948 ExReinitializeResourceLite(
14949 _Inout_ PERESOURCE Resource
);
14951 _IRQL_requires_max_(DISPATCH_LEVEL
)
14952 _Requires_lock_held_(_Global_critical_region_
)
14956 ExReleaseResourceForThreadLite(
14957 _Inout_
_Requires_lock_held_(*_Curr_
) _Releases_lock_(*_Curr_
)
14958 PERESOURCE Resource
,
14959 _In_ ERESOURCE_THREAD ResourceThreadId
);
14961 _Requires_lock_held_(_Global_critical_region_
)
14962 _Requires_lock_held_(*Resource
)
14963 _Releases_lock_(*Resource
)
14964 _IRQL_requires_max_(DISPATCH_LEVEL
)
14968 ExReleaseResourceLite(
14969 _Inout_ PERESOURCE Resource
);
14971 _IRQL_requires_max_(DISPATCH_LEVEL
)
14975 ExSetResourceOwnerPointer(
14976 _Inout_ PERESOURCE Resource
,
14977 _In_ PVOID OwnerPointer
);
14979 _IRQL_requires_max_(APC_LEVEL
)
14983 ExSetTimerResolution(
14984 _In_ ULONG DesiredTime
,
14985 _In_ BOOLEAN SetResolution
);
14990 ExSystemTimeToLocalTime(
14991 _In_ PLARGE_INTEGER SystemTime
,
14992 _Out_ PLARGE_INTEGER LocalTime
);
14994 _IRQL_requires_max_(APC_LEVEL
)
14998 ExUnregisterCallback(
14999 _Inout_ PVOID CbRegistration
);
15001 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
15003 #if (NTDDI_VERSION >= NTDDI_WINXP)
15005 _Must_inspect_result_
15006 _Post_satisfies_(return == 0 || return == 1)
15010 ExAcquireRundownProtection(
15011 _Inout_ PEX_RUNDOWN_REF RunRef
);
15016 ExInitializeRundownProtection(
15017 _Out_ PEX_RUNDOWN_REF RunRef
);
15022 ExReInitializeRundownProtection(
15023 _Inout_ PEX_RUNDOWN_REF RunRef
);
15028 ExReleaseRundownProtection(
15029 _Inout_ PEX_RUNDOWN_REF RunRef
);
15034 ExRundownCompleted(
15035 _Out_ PEX_RUNDOWN_REF RunRef
);
15041 __drv_strictTypeMatch(__drv_typeExpr
) _In_ SUITE_TYPE SuiteType
);
15046 ExWaitForRundownProtectionRelease(
15047 _Inout_ PEX_RUNDOWN_REF RunRef
);
15048 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) */
15050 #if (NTDDI_VERSION >= NTDDI_WINXPSP2)
15052 _Must_inspect_result_
15053 _Post_satisfies_(return == 0 || return == 1)
15057 ExAcquireRundownProtectionEx(
15058 _Inout_ PEX_RUNDOWN_REF RunRef
,
15064 ExReleaseRundownProtectionEx(
15065 _Inout_ PEX_RUNDOWN_REF RunRef
,
15068 #endif /* (NTDDI_VERSION >= NTDDI_WINXPSP2) */
15070 #if (NTDDI_VERSION >= NTDDI_WS03SP1)
15072 _Must_inspect_result_
15073 _IRQL_requires_max_(APC_LEVEL
)
15075 PEX_RUNDOWN_REF_CACHE_AWARE
15077 ExAllocateCacheAwareRundownProtection(
15078 __drv_strictTypeMatch(__drv_typeExpr
) _In_ POOL_TYPE PoolType
,
15079 _In_ ULONG PoolTag
);
15081 _IRQL_requires_max_(APC_LEVEL
)
15085 ExSizeOfRundownProtectionCacheAware(VOID
);
15087 _IRQL_requires_max_(APC_LEVEL
)
15088 _Acquires_lock_(_Global_critical_region_
)
15092 ExEnterCriticalRegionAndAcquireResourceShared(
15093 _Inout_
_Requires_lock_not_held_(*_Curr_
) _Acquires_shared_lock_(*_Curr_
)
15094 PERESOURCE Resource
);
15096 _IRQL_requires_max_(APC_LEVEL
)
15097 _Acquires_lock_(_Global_critical_region_
)
15101 ExEnterCriticalRegionAndAcquireResourceExclusive(
15102 _Inout_
_Requires_lock_not_held_(*_Curr_
) _Acquires_exclusive_lock_(*_Curr_
)
15103 PERESOURCE Resource
);
15105 _IRQL_requires_max_(APC_LEVEL
)
15106 _Acquires_lock_(_Global_critical_region_
)
15110 ExEnterCriticalRegionAndAcquireSharedWaitForExclusive(
15111 _Inout_
_Requires_lock_not_held_(*_Curr_
) _Acquires_lock_(*_Curr_
)
15112 PERESOURCE Resource
);
15114 _IRQL_requires_max_(DISPATCH_LEVEL
)
15115 _Releases_lock_(_Global_critical_region_
)
15119 ExReleaseResourceAndLeaveCriticalRegion(
15120 _Inout_
_Requires_lock_held_(*_Curr_
) _Releases_lock_(*_Curr_
)
15121 PERESOURCE Resource
);
15123 _IRQL_requires_max_(APC_LEVEL
)
15127 ExInitializeRundownProtectionCacheAware(
15128 _Out_ PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
,
15129 _In_ SIZE_T RunRefSize
);
15131 _IRQL_requires_max_(APC_LEVEL
)
15135 ExFreeCacheAwareRundownProtection(
15136 _Inout_ PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);
15138 _Must_inspect_result_
15139 _Post_satisfies_(return == 0 || return == 1)
15143 ExAcquireRundownProtectionCacheAware(
15144 _Inout_ PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);
15149 ExReleaseRundownProtectionCacheAware(
15150 _Inout_ PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);
15152 _Must_inspect_result_
15153 _Post_satisfies_(return == 0 || return == 1)
15157 ExAcquireRundownProtectionCacheAwareEx(
15158 _Inout_ PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
,
15164 ExReleaseRundownProtectionCacheAwareEx(
15165 _Inout_ PEX_RUNDOWN_REF_CACHE_AWARE RunRef
,
15171 ExWaitForRundownProtectionReleaseCacheAware(
15172 IN OUT PEX_RUNDOWN_REF_CACHE_AWARE RunRef
);
15177 ExReInitializeRundownProtectionCacheAware(
15178 _Inout_ PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);
15183 ExRundownCompletedCacheAware(
15184 _Inout_ PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);
15186 #endif /* (NTDDI_VERSION >= NTDDI_WS03SP1) */
15188 #if (NTDDI_VERSION >= NTDDI_VISTA)
15190 _IRQL_requires_max_(DISPATCH_LEVEL
)
15194 ExInitializeLookasideListEx(
15195 _Out_ PLOOKASIDE_LIST_EX Lookaside
,
15196 _In_opt_ PALLOCATE_FUNCTION_EX Allocate
,
15197 _In_opt_ PFREE_FUNCTION_EX Free
,
15198 _In_ POOL_TYPE PoolType
,
15202 _In_ USHORT Depth
);
15204 _IRQL_requires_max_(DISPATCH_LEVEL
)
15208 ExDeleteLookasideListEx(
15209 _Inout_ PLOOKASIDE_LIST_EX Lookaside
);
15211 _IRQL_requires_max_(DISPATCH_LEVEL
)
15215 ExFlushLookasideListEx(
15216 _Inout_ PLOOKASIDE_LIST_EX Lookaside
);
15218 _Must_inspect_result_
15219 _IRQL_requires_max_(DISPATCH_LEVEL
)
15222 ExAllocateFromLookasideListEx(
15223 _Inout_ PLOOKASIDE_LIST_EX Lookaside
)
15227 Lookaside
->L
.TotalAllocates
+= 1;
15228 #ifdef NONAMELESSUNION
15229 Entry
= InterlockedPopEntrySList(&Lookaside
->L
.u
.ListHead
);
15230 if (Entry
== NULL
) {
15231 Lookaside
->L
.u2
.AllocateMisses
+= 1;
15232 Entry
= (Lookaside
->L
.u4
.AllocateEx
)(Lookaside
->L
.Type
,
15237 #else /* NONAMELESSUNION */
15238 Entry
= InterlockedPopEntrySList(&Lookaside
->L
.ListHead
);
15239 if (Entry
== NULL
) {
15240 Lookaside
->L
.AllocateMisses
+= 1;
15241 Entry
= (Lookaside
->L
.AllocateEx
)(Lookaside
->L
.Type
,
15246 #endif /* NONAMELESSUNION */
15250 _IRQL_requires_max_(DISPATCH_LEVEL
)
15253 ExFreeToLookasideListEx(
15254 _Inout_ PLOOKASIDE_LIST_EX Lookaside
,
15257 Lookaside
->L
.TotalFrees
+= 1;
15258 if (ExQueryDepthSList(&Lookaside
->L
.ListHead
) >= Lookaside
->L
.Depth
) {
15259 Lookaside
->L
.FreeMisses
+= 1;
15260 (Lookaside
->L
.FreeEx
)(Entry
, Lookaside
);
15262 InterlockedPushEntrySList(&Lookaside
->L
.ListHead
, (PSLIST_ENTRY
)Entry
);
15267 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
15269 #if (NTDDI_VERSION >= NTDDI_WIN7)
15271 _IRQL_requires_max_(DISPATCH_LEVEL
)
15275 ExSetResourceOwnerPointerEx(
15276 _Inout_ PERESOURCE Resource
,
15277 _In_ PVOID OwnerPointer
,
15280 #define FLAG_OWNER_POINTER_IS_THREAD 0x1
15282 #endif /* (NTDDI_VERSION >= NTDDI_WIN7) */
15284 _IRQL_requires_max_(DISPATCH_LEVEL
)
15285 static __inline PVOID
15286 ExAllocateFromNPagedLookasideList(
15287 _Inout_ PNPAGED_LOOKASIDE_LIST Lookaside
)
15291 Lookaside
->L
.TotalAllocates
++;
15292 #ifdef NONAMELESSUNION
15293 #if defined(_WIN2K_COMPAT_SLIST_USAGE) && defined(_X86_)
15294 Entry
= ExInterlockedPopEntrySList(&Lookaside
->L
.u
.ListHead
,
15295 &Lookaside
->Lock__ObsoleteButDoNotDelete
);
15297 Entry
= InterlockedPopEntrySList(&Lookaside
->L
.u
.ListHead
);
15299 if (Entry
== NULL
) {
15300 Lookaside
->L
.u2
.AllocateMisses
++;
15301 Entry
= (Lookaside
->L
.u4
.Allocate
)(Lookaside
->L
.Type
,
15305 #else /* NONAMELESSUNION */
15306 #if defined(_WIN2K_COMPAT_SLIST_USAGE) && defined(_X86_)
15307 Entry
= ExInterlockedPopEntrySList(&Lookaside
->L
.ListHead
,
15308 &Lookaside
->Lock__ObsoleteButDoNotDelete
);
15310 Entry
= InterlockedPopEntrySList(&Lookaside
->L
.ListHead
);
15312 if (Entry
== NULL
) {
15313 Lookaside
->L
.AllocateMisses
++;
15314 Entry
= (Lookaside
->L
.Allocate
)(Lookaside
->L
.Type
,
15318 #endif /* NONAMELESSUNION */
15322 _IRQL_requires_max_(DISPATCH_LEVEL
)
15323 static __inline VOID
15324 ExFreeToNPagedLookasideList(
15325 _Inout_ PNPAGED_LOOKASIDE_LIST Lookaside
,
15328 Lookaside
->L
.TotalFrees
++;
15329 #ifdef NONAMELESSUNION
15330 if (ExQueryDepthSList(&Lookaside
->L
.u
.ListHead
) >= Lookaside
->L
.Depth
) {
15331 Lookaside
->L
.u3
.FreeMisses
++;
15332 (Lookaside
->L
.u5
.Free
)(Entry
);
15334 #if defined(_WIN2K_COMPAT_SLIST_USAGE) && defined(_X86_)
15335 ExInterlockedPushEntrySList(&Lookaside
->L
.u
.ListHead
,
15336 (PSLIST_ENTRY
)Entry
,
15337 &Lookaside
->Lock__ObsoleteButDoNotDelete
);
15339 InterlockedPushEntrySList(&Lookaside
->L
.u
.ListHead
, (PSLIST_ENTRY
)Entry
);
15342 #else /* NONAMELESSUNION */
15343 if (ExQueryDepthSList(&Lookaside
->L
.ListHead
) >= Lookaside
->L
.Depth
) {
15344 Lookaside
->L
.FreeMisses
++;
15345 (Lookaside
->L
.Free
)(Entry
);
15347 #if defined(_WIN2K_COMPAT_SLIST_USAGE) && defined(_X86_)
15348 ExInterlockedPushEntrySList(&Lookaside
->L
.ListHead
,
15349 (PSLIST_ENTRY
)Entry
,
15350 &Lookaside
->Lock__ObsoleteButDoNotDelete
);
15352 InterlockedPushEntrySList(&Lookaside
->L
.ListHead
, (PSLIST_ENTRY
)Entry
);
15355 #endif /* NONAMELESSUNION */
15358 /******************************************************************************
15359 * Object Manager Functions *
15360 ******************************************************************************/
15362 #if (NTDDI_VERSION >= NTDDI_WIN2K)
15363 _IRQL_requires_max_(DISPATCH_LEVEL
)
15367 ObfDereferenceObject(
15368 _In_ PVOID Object
);
15369 #define ObDereferenceObject ObfDereferenceObject
15371 _IRQL_requires_max_(APC_LEVEL
)
15375 ObGetObjectSecurity(
15377 _Out_ PSECURITY_DESCRIPTOR
*SecurityDescriptor
,
15378 _Out_ PBOOLEAN MemoryAllocated
);
15380 _IRQL_requires_max_(DISPATCH_LEVEL
)
15384 ObfReferenceObject(
15385 _In_ PVOID Object
);
15386 #define ObReferenceObject ObfReferenceObject
15388 _IRQL_requires_max_(APC_LEVEL
)
15392 ObReferenceObjectByHandle(
15393 _In_ HANDLE Handle
,
15394 _In_ ACCESS_MASK DesiredAccess
,
15395 _In_opt_ POBJECT_TYPE ObjectType
,
15396 _In_ KPROCESSOR_MODE AccessMode
,
15397 _Out_ PVOID
*Object
,
15398 _Out_opt_ POBJECT_HANDLE_INFORMATION HandleInformation
);
15400 _IRQL_requires_max_(DISPATCH_LEVEL
)
15404 ObReferenceObjectByPointer(
15406 _In_ ACCESS_MASK DesiredAccess
,
15407 _In_opt_ POBJECT_TYPE ObjectType
,
15408 _In_ KPROCESSOR_MODE AccessMode
);
15410 _IRQL_requires_max_(APC_LEVEL
)
15414 ObReleaseObjectSecurity(
15415 _In_ PSECURITY_DESCRIPTOR SecurityDescriptor
,
15416 _In_ BOOLEAN MemoryAllocated
);
15417 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
15419 #if (NTDDI_VERSION >= NTDDI_VISTA)
15423 ObDereferenceObjectDeferDelete(
15424 _In_ PVOID Object
);
15427 #if (NTDDI_VERSION >= NTDDI_VISTASP1)
15431 ObRegisterCallbacks(
15432 _In_ POB_CALLBACK_REGISTRATION CallbackRegistration
,
15433 _Outptr_ PVOID
*RegistrationHandle
);
15438 ObUnRegisterCallbacks(
15439 _In_ PVOID RegistrationHandle
);
15444 ObGetFilterVersion(VOID
);
15446 #endif /* (NTDDI_VERSION >= NTDDI_VISTASP1) */
15448 #if (NTDDI_VERSION >= NTDDI_WIN7)
15449 _IRQL_requires_max_(APC_LEVEL
)
15453 ObReferenceObjectByHandleWithTag(
15454 _In_ HANDLE Handle
,
15455 _In_ ACCESS_MASK DesiredAccess
,
15456 _In_opt_ POBJECT_TYPE ObjectType
,
15457 _In_ KPROCESSOR_MODE AccessMode
,
15459 _Out_ PVOID
*Object
,
15460 _Out_opt_ POBJECT_HANDLE_INFORMATION HandleInformation
);
15462 _IRQL_requires_max_(DISPATCH_LEVEL
)
15466 ObfReferenceObjectWithTag(
15470 _IRQL_requires_max_(DISPATCH_LEVEL
)
15474 ObReferenceObjectByPointerWithTag(
15476 _In_ ACCESS_MASK DesiredAccess
,
15477 _In_opt_ POBJECT_TYPE ObjectType
,
15478 _In_ KPROCESSOR_MODE AccessMode
,
15481 _IRQL_requires_max_(DISPATCH_LEVEL
)
15485 ObfDereferenceObjectWithTag(
15492 ObDereferenceObjectDeferDeleteWithTag(
15496 #define ObDereferenceObject ObfDereferenceObject
15497 #define ObReferenceObject ObfReferenceObject
15498 #define ObDereferenceObjectWithTag ObfDereferenceObjectWithTag
15499 #define ObReferenceObjectWithTag ObfReferenceObjectWithTag
15500 #endif /* (NTDDI_VERSION >= NTDDI_WIN7) */
15502 /******************************************************************************
15503 * Process Manager Functions *
15504 ******************************************************************************/
15509 PsWrapApcWow64Thread(
15510 _Inout_ PVOID
*ApcContext
,
15511 _Inout_ PVOID
*ApcRoutine
);
15515 * PsGetCurrentProcess(VOID)
15517 #define PsGetCurrentProcess IoGetCurrentProcess
15519 #if !defined(_PSGETCURRENTTHREAD_)
15520 #define _PSGETCURRENTTHREAD_
15521 _IRQL_requires_max_(DISPATCH_LEVEL
)
15525 PsGetCurrentThread(VOID
)
15527 return (PETHREAD
)KeGetCurrentThread();
15529 #endif /* !_PSGETCURRENTTHREAD_ */
15532 #if (NTDDI_VERSION >= NTDDI_WIN2K)
15534 _IRQL_requires_max_(APC_LEVEL
)
15535 _Post_satisfies_(return <= 0)
15536 _Must_inspect_result_
15540 PsCreateSystemThread(
15541 _Out_ PHANDLE ThreadHandle
,
15542 _In_ ULONG DesiredAccess
,
15543 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
15544 _In_opt_ HANDLE ProcessHandle
,
15545 _Out_opt_ PCLIENT_ID ClientId
,
15546 _In_ PKSTART_ROUTINE StartRoutine
,
15547 _In_opt_
_When_(return==0, __drv_aliasesMem
) PVOID StartContext
);
15549 _IRQL_requires_max_(PASSIVE_LEVEL
)
15553 PsTerminateSystemThread(
15554 _In_ NTSTATUS ExitStatus
);
15556 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
15559 /******************************************************************************
15560 * WMI Library Support Functions *
15561 ******************************************************************************/
15564 #if (NTDDI_VERSION >= NTDDI_WINXP)
15565 _IRQL_requires_max_(HIGH_LEVEL
)
15570 _In_ TRACEHANDLE LoggerHandle
,
15571 _In_ ULONG MessageFlags
,
15572 _In_ LPGUID MessageGuid
,
15573 _In_ USHORT MessageNumber
,
15576 #endif /* RUN_WPP */
15578 #if (NTDDI_VERSION >= NTDDI_WINXP)
15580 _IRQL_requires_max_(APC_LEVEL
)
15584 WmiQueryTraceInformation(
15585 _In_ TRACE_INFORMATION_CLASS TraceInformationClass
,
15586 _Out_writes_bytes_(TraceInformationLength
) PVOID TraceInformation
,
15587 _In_ ULONG TraceInformationLength
,
15588 _Out_opt_ PULONG RequiredLength
,
15589 _In_opt_ PVOID Buffer
);
15592 /* FIXME: Get va_list from where? */
15593 _IRQL_requires_max_(HIGH_LEVEL
)
15598 _In_ TRACEHANDLE LoggerHandle
,
15599 _In_ ULONG MessageFlags
,
15600 _In_ LPGUID MessageGuid
,
15601 _In_ USHORT MessageNumber
,
15602 _In_
va_list MessageArgList
);
15605 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) */
15607 #ifndef TRACE_INFORMATION_CLASS_DEFINE
15609 #if (NTDDI_VERSION >= NTDDI_WINXP)
15610 _IRQL_requires_max_(APC_LEVEL
)
15614 WmiQueryTraceInformation(
15615 _In_ TRACE_INFORMATION_CLASS TraceInformationClass
,
15616 _Out_writes_bytes_(TraceInformationLength
) PVOID TraceInformation
,
15617 _In_ ULONG TraceInformationLength
,
15618 _Out_opt_ PULONG RequiredLength
,
15619 _In_opt_ PVOID Buffer
);
15622 #define TRACE_INFORMATION_CLASS_DEFINE
15624 #endif /* TRACE_INFOPRMATION_CLASS_DEFINE */
15626 #if (NTDDI_VERSION >= NTDDI_VISTA)
15628 _IRQL_requires_max_(PASSIVE_LEVEL
)
15633 _In_ LPCGUID ProviderId
,
15634 _In_opt_ PETWENABLECALLBACK EnableCallback
,
15635 _In_opt_ PVOID CallbackContext
,
15636 _Out_ PREGHANDLE RegHandle
);
15638 _IRQL_requires_max_(PASSIVE_LEVEL
)
15643 _In_ REGHANDLE RegHandle
);
15645 _IRQL_requires_max_(HIGH_LEVEL
)
15650 _In_ REGHANDLE RegHandle
,
15651 _In_ PCEVENT_DESCRIPTOR EventDescriptor
);
15653 _IRQL_requires_max_(HIGH_LEVEL
)
15657 EtwProviderEnabled(
15658 _In_ REGHANDLE RegHandle
,
15660 _In_ ULONGLONG Keyword
);
15662 _When_(ControlCode
==EVENT_ACTIVITY_CTRL_CREATE_ID
, _IRQL_requires_max_(HIGH_LEVEL
))
15663 _When_(ControlCode
!=EVENT_ACTIVITY_CTRL_CREATE_ID
, _IRQL_requires_max_(APC_LEVEL
))
15667 EtwActivityIdControl(
15668 _In_ ULONG ControlCode
,
15669 _Inout_updates_bytes_(sizeof(GUID
)) LPGUID ActivityId
);
15671 _IRQL_requires_max_(HIGH_LEVEL
)
15676 _In_ REGHANDLE RegHandle
,
15677 _In_ PCEVENT_DESCRIPTOR EventDescriptor
,
15678 _In_opt_ LPCGUID ActivityId
,
15679 _In_ ULONG UserDataCount
,
15680 _In_reads_opt_(UserDataCount
) PEVENT_DATA_DESCRIPTOR UserData
);
15682 _IRQL_requires_max_(HIGH_LEVEL
)
15687 _In_ REGHANDLE RegHandle
,
15688 _In_ PCEVENT_DESCRIPTOR EventDescriptor
,
15689 _In_opt_ LPCGUID ActivityId
,
15690 _In_opt_ LPCGUID RelatedActivityId
,
15691 _In_ ULONG UserDataCount
,
15692 _In_reads_opt_(UserDataCount
) PEVENT_DATA_DESCRIPTOR UserData
);
15694 _IRQL_requires_max_(HIGH_LEVEL
)
15699 _In_ REGHANDLE RegHandle
,
15701 _In_ ULONGLONG Keyword
,
15702 _In_opt_ LPCGUID ActivityId
,
15703 _In_ PCWSTR String
);
15705 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
15707 #if (NTDDI_VERSION >= NTDDI_WIN7)
15708 _IRQL_requires_max_(HIGH_LEVEL
)
15713 _In_ REGHANDLE RegHandle
,
15714 _In_ PCEVENT_DESCRIPTOR EventDescriptor
,
15715 _In_ ULONG64 Filter
,
15717 _In_opt_ LPCGUID ActivityId
,
15718 _In_opt_ LPCGUID RelatedActivityId
,
15719 _In_ ULONG UserDataCount
,
15720 _In_reads_opt_(UserDataCount
) PEVENT_DATA_DESCRIPTOR UserData
);
15725 /******************************************************************************
15726 * Kernel Debugger Functions *
15727 ******************************************************************************/
15734 _In_z_ _Printf_format_string_ PCSTR Format
,
15737 #if (NTDDI_VERSION >= NTDDI_WIN2K)
15741 DbgPrintReturnControlC(
15742 _In_z_ _Printf_format_string_ PCCH Format
,
15746 #if (NTDDI_VERSION >= NTDDI_WINXP)
15752 _In_ ULONG ComponentId
,
15754 _In_z_ _Printf_format_string_ PCSTR Format
,
15757 #ifdef _VA_LIST_DEFINED
15763 _In_ ULONG ComponentId
,
15765 _In_z_ PCCH Format
,
15771 vDbgPrintExWithPrefix(
15772 _In_z_ PCCH Prefix
,
15773 _In_ ULONG ComponentId
,
15775 _In_z_ PCCH Format
,
15778 #endif /* _VA_LIST_DEFINED */
15783 DbgQueryDebugFilterState(
15784 _In_ ULONG ComponentId
,
15790 DbgSetDebugFilterState(
15791 _In_ ULONG ComponentId
,
15793 _In_ BOOLEAN State
);
15795 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) */
15797 #if (NTDDI_VERSION >= NTDDI_VISTA)
15800 (*PDEBUG_PRINT_CALLBACK
)(
15801 _In_ PSTRING Output
,
15802 _In_ ULONG ComponentId
,
15808 DbgSetDebugPrintCallback(
15809 _In_ PDEBUG_PRINT_CALLBACK DebugPrintCallback
,
15810 _In_ BOOLEAN Enable
);
15812 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
15814 #endif /* _DBGNT_ */
15818 #define KdPrint(_x_) DbgPrint _x_
15819 #define KdPrintEx(_x_) DbgPrintEx _x_
15820 #define vKdPrintEx(_x_) vDbgPrintEx _x_
15821 #define vKdPrintExWithPrefix(_x_) vDbgPrintExWithPrefix _x_
15822 #define KdBreakPoint() DbgBreakPoint()
15823 #define KdBreakPointWithStatus(s) DbgBreakPointWithStatus(s)
15827 #define KdPrint(_x_)
15828 #define KdPrintEx(_x_)
15829 #define vKdPrintEx(_x_)
15830 #define vKdPrintExWithPrefix(_x_)
15831 #define KdBreakPoint()
15832 #define KdBreakPointWithStatus(s)
15837 extern BOOLEAN KdDebuggerEnabled
;
15838 #define KD_DEBUGGER_ENABLED KdDebuggerEnabled
15839 extern BOOLEAN KdDebuggerNotPresent
;
15840 #define KD_DEBUGGER_NOT_PRESENT KdDebuggerNotPresent
15842 extern BOOLEAN
*KdDebuggerEnabled
;
15843 __CREATE_NTOS_DATA_IMPORT_ALIAS(KdDebuggerEnabled
)
15844 #define KD_DEBUGGER_ENABLED (*KdDebuggerEnabled)
15845 extern BOOLEAN
*KdDebuggerNotPresent
;
15846 __CREATE_NTOS_DATA_IMPORT_ALIAS(KdDebuggerNotPresent
)
15847 #define KD_DEBUGGER_NOT_PRESENT (*KdDebuggerNotPresent)
15850 #if (NTDDI_VERSION >= NTDDI_WIN2K)
15855 KdDisableDebugger(VOID
);
15860 KdEnableDebugger(VOID
);
15862 #if (_MSC_FULL_VER >= 150030729) && !defined(IMPORT_NATIVE_DBG_BREAK)
15863 #define DbgBreakPoint __debugbreak
15865 __analysis_noreturn
15868 DbgBreakPoint(VOID
);
15871 __analysis_noreturn
15875 DbgBreakPointWithStatus(
15876 _In_ ULONG Status
);
15878 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
15880 #if (NTDDI_VERSION >= NTDDI_WS03)
15884 KdRefreshDebuggerNotPresent(VOID
);
15887 #if (NTDDI_VERSION >= NTDDI_WS03SP1)
15892 _In_ KD_OPTION Option
,
15893 _In_opt_ ULONG InBufferBytes
,
15894 _In_ PVOID InBuffer
,
15895 _In_opt_ ULONG OutBufferBytes
,
15896 _Out_ PVOID OutBuffer
,
15897 _Out_opt_ PULONG OutBufferNeeded
);
15899 /* Hardware Abstraction Layer Functions */
15901 #if (NTDDI_VERSION >= NTDDI_WIN2K)
15903 #if defined(USE_DMA_MACROS) && !defined(_NTHAL_) && (defined(_NTDDK_) || defined(_NTDRIVER_)) || defined(_WDM_INCLUDED_)
15905 __drv_preferredFunction("AllocateCommonBuffer","Obsolete")
15909 HalAllocateCommonBuffer(
15910 _In_ PDMA_ADAPTER DmaAdapter
,
15912 _Out_ PPHYSICAL_ADDRESS LogicalAddress
,
15913 _In_ BOOLEAN CacheEnabled
)
15915 PALLOCATE_COMMON_BUFFER allocateCommonBuffer
;
15916 PVOID commonBuffer
;
15918 allocateCommonBuffer
= *(DmaAdapter
)->DmaOperations
->AllocateCommonBuffer
;
15919 ASSERT( allocateCommonBuffer
!= NULL
);
15920 commonBuffer
= allocateCommonBuffer( DmaAdapter
, Length
, LogicalAddress
, CacheEnabled
);
15921 return commonBuffer
;
15924 __drv_preferredFunction("FreeCommonBuffer","Obsolete")
15928 HalFreeCommonBuffer(
15929 _In_ PDMA_ADAPTER DmaAdapter
,
15931 _In_ PHYSICAL_ADDRESS LogicalAddress
,
15932 _In_ PVOID VirtualAddress
,
15933 _In_ BOOLEAN CacheEnabled
)
15935 PFREE_COMMON_BUFFER freeCommonBuffer
;
15937 freeCommonBuffer
= *(DmaAdapter
)->DmaOperations
->FreeCommonBuffer
;
15938 ASSERT( freeCommonBuffer
!= NULL
);
15939 freeCommonBuffer( DmaAdapter
, Length
, LogicalAddress
, VirtualAddress
, CacheEnabled
);
15942 __drv_preferredFunction("ReadDmaCounter","Obsolete")
15947 _In_ PDMA_ADAPTER DmaAdapter
)
15949 PREAD_DMA_COUNTER readDmaCounter
;
15952 readDmaCounter
= *(DmaAdapter
)->DmaOperations
->ReadDmaCounter
;
15953 ASSERT( readDmaCounter
!= NULL
);
15954 counter
= readDmaCounter( DmaAdapter
);
15960 HalGetDmaAlignment(
15961 _In_ PDMA_ADAPTER DmaAdapter
)
15963 PGET_DMA_ALIGNMENT getDmaAlignment
;
15966 getDmaAlignment
= *(DmaAdapter
)->DmaOperations
->GetDmaAlignment
;
15967 ASSERT( getDmaAlignment
!= NULL
);
15968 alignment
= getDmaAlignment( DmaAdapter
);
15972 #endif /* USE_DMA_MACROS ... */
15974 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
15979 #include <ktmtypes.h>
15981 #define TRANSACTIONMANAGER_QUERY_INFORMATION (0x0001)
15982 #define TRANSACTIONMANAGER_SET_INFORMATION (0x0002)
15983 #define TRANSACTIONMANAGER_RECOVER (0x0004)
15984 #define TRANSACTIONMANAGER_RENAME (0x0008)
15985 #define TRANSACTIONMANAGER_CREATE_RM (0x0010)
15986 #define TRANSACTIONMANAGER_BIND_TRANSACTION (0x0020)
15988 #define TRANSACTIONMANAGER_GENERIC_READ (STANDARD_RIGHTS_READ |\
15989 TRANSACTIONMANAGER_QUERY_INFORMATION)
15991 #define TRANSACTIONMANAGER_GENERIC_WRITE (STANDARD_RIGHTS_WRITE |\
15992 TRANSACTIONMANAGER_SET_INFORMATION |\
15993 TRANSACTIONMANAGER_RECOVER |\
15994 TRANSACTIONMANAGER_RENAME |\
15995 TRANSACTIONMANAGER_CREATE_RM)
15997 #define TRANSACTIONMANAGER_GENERIC_EXECUTE (STANDARD_RIGHTS_EXECUTE)
15999 #define TRANSACTIONMANAGER_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED |\
16000 TRANSACTIONMANAGER_GENERIC_READ |\
16001 TRANSACTIONMANAGER_GENERIC_WRITE |\
16002 TRANSACTIONMANAGER_GENERIC_EXECUTE |\
16003 TRANSACTIONMANAGER_BIND_TRANSACTION)
16005 #define TRANSACTION_QUERY_INFORMATION (0x0001)
16006 #define TRANSACTION_SET_INFORMATION (0x0002)
16007 #define TRANSACTION_ENLIST (0x0004)
16008 #define TRANSACTION_COMMIT (0x0008)
16009 #define TRANSACTION_ROLLBACK (0x0010)
16010 #define TRANSACTION_PROPAGATE (0x0020)
16011 #define TRANSACTION_RIGHT_RESERVED1 (0x0040)
16013 #define TRANSACTION_GENERIC_READ (STANDARD_RIGHTS_READ |\
16014 TRANSACTION_QUERY_INFORMATION |\
16017 #define TRANSACTION_GENERIC_WRITE (STANDARD_RIGHTS_WRITE |\
16018 TRANSACTION_SET_INFORMATION |\
16019 TRANSACTION_COMMIT |\
16020 TRANSACTION_ENLIST |\
16021 TRANSACTION_ROLLBACK |\
16022 TRANSACTION_PROPAGATE |\
16025 #define TRANSACTION_GENERIC_EXECUTE (STANDARD_RIGHTS_EXECUTE |\
16026 TRANSACTION_COMMIT |\
16027 TRANSACTION_ROLLBACK |\
16030 #define TRANSACTION_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED |\
16031 TRANSACTION_GENERIC_READ |\
16032 TRANSACTION_GENERIC_WRITE |\
16033 TRANSACTION_GENERIC_EXECUTE)
16035 #define TRANSACTION_RESOURCE_MANAGER_RIGHTS (TRANSACTION_GENERIC_READ |\
16036 STANDARD_RIGHTS_WRITE |\
16037 TRANSACTION_SET_INFORMATION |\
16038 TRANSACTION_ENLIST |\
16039 TRANSACTION_ROLLBACK |\
16040 TRANSACTION_PROPAGATE |\
16043 #define RESOURCEMANAGER_QUERY_INFORMATION (0x0001)
16044 #define RESOURCEMANAGER_SET_INFORMATION (0x0002)
16045 #define RESOURCEMANAGER_RECOVER (0x0004)
16046 #define RESOURCEMANAGER_ENLIST (0x0008)
16047 #define RESOURCEMANAGER_GET_NOTIFICATION (0x0010)
16048 #define RESOURCEMANAGER_REGISTER_PROTOCOL (0x0020)
16049 #define RESOURCEMANAGER_COMPLETE_PROPAGATION (0x0040)
16051 #define RESOURCEMANAGER_GENERIC_READ (STANDARD_RIGHTS_READ |\
16052 RESOURCEMANAGER_QUERY_INFORMATION |\
16055 #define RESOURCEMANAGER_GENERIC_WRITE (STANDARD_RIGHTS_WRITE |\
16056 RESOURCEMANAGER_SET_INFORMATION |\
16057 RESOURCEMANAGER_RECOVER |\
16058 RESOURCEMANAGER_ENLIST |\
16059 RESOURCEMANAGER_GET_NOTIFICATION |\
16060 RESOURCEMANAGER_REGISTER_PROTOCOL |\
16061 RESOURCEMANAGER_COMPLETE_PROPAGATION |\
16064 #define RESOURCEMANAGER_GENERIC_EXECUTE (STANDARD_RIGHTS_EXECUTE |\
16065 RESOURCEMANAGER_RECOVER |\
16066 RESOURCEMANAGER_ENLIST |\
16067 RESOURCEMANAGER_GET_NOTIFICATION |\
16068 RESOURCEMANAGER_COMPLETE_PROPAGATION |\
16071 #define RESOURCEMANAGER_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED |\
16072 RESOURCEMANAGER_GENERIC_READ |\
16073 RESOURCEMANAGER_GENERIC_WRITE |\
16074 RESOURCEMANAGER_GENERIC_EXECUTE)
16076 #define ENLISTMENT_QUERY_INFORMATION (0x0001)
16077 #define ENLISTMENT_SET_INFORMATION (0x0002)
16078 #define ENLISTMENT_RECOVER (0x0004)
16079 #define ENLISTMENT_SUBORDINATE_RIGHTS (0x0008)
16080 #define ENLISTMENT_SUPERIOR_RIGHTS (0x0010)
16082 #define ENLISTMENT_GENERIC_READ (STANDARD_RIGHTS_READ |\
16083 ENLISTMENT_QUERY_INFORMATION)
16085 #define ENLISTMENT_GENERIC_WRITE (STANDARD_RIGHTS_WRITE |\
16086 ENLISTMENT_SET_INFORMATION |\
16087 ENLISTMENT_RECOVER |\
16088 ENLISTMENT_SUBORDINATE_RIGHTS |\
16089 ENLISTMENT_SUPERIOR_RIGHTS)
16091 #define ENLISTMENT_GENERIC_EXECUTE (STANDARD_RIGHTS_EXECUTE |\
16092 ENLISTMENT_RECOVER |\
16093 ENLISTMENT_SUBORDINATE_RIGHTS |\
16094 ENLISTMENT_SUPERIOR_RIGHTS)
16096 #define ENLISTMENT_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED |\
16097 ENLISTMENT_GENERIC_READ |\
16098 ENLISTMENT_GENERIC_WRITE |\
16099 ENLISTMENT_GENERIC_EXECUTE)
16101 typedef enum _TRANSACTION_OUTCOME
{
16102 TransactionOutcomeUndetermined
= 1,
16103 TransactionOutcomeCommitted
,
16104 TransactionOutcomeAborted
,
16105 } TRANSACTION_OUTCOME
;
16108 typedef enum _TRANSACTION_STATE
{
16109 TransactionStateNormal
= 1,
16110 TransactionStateIndoubt
,
16111 TransactionStateCommittedNotify
,
16112 } TRANSACTION_STATE
;
16115 typedef struct _TRANSACTION_BASIC_INFORMATION
{
16116 GUID TransactionId
;
16119 } TRANSACTION_BASIC_INFORMATION
, *PTRANSACTION_BASIC_INFORMATION
;
16121 typedef struct _TRANSACTIONMANAGER_BASIC_INFORMATION
{
16123 LARGE_INTEGER VirtualClock
;
16124 } TRANSACTIONMANAGER_BASIC_INFORMATION
, *PTRANSACTIONMANAGER_BASIC_INFORMATION
;
16126 typedef struct _TRANSACTIONMANAGER_LOG_INFORMATION
{
16128 } TRANSACTIONMANAGER_LOG_INFORMATION
, *PTRANSACTIONMANAGER_LOG_INFORMATION
;
16130 typedef struct _TRANSACTIONMANAGER_LOGPATH_INFORMATION
{
16131 ULONG LogPathLength
;
16132 _Field_size_(LogPathLength
) WCHAR LogPath
[1];
16133 } TRANSACTIONMANAGER_LOGPATH_INFORMATION
, *PTRANSACTIONMANAGER_LOGPATH_INFORMATION
;
16135 typedef struct _TRANSACTIONMANAGER_RECOVERY_INFORMATION
{
16136 ULONGLONG LastRecoveredLsn
;
16137 } TRANSACTIONMANAGER_RECOVERY_INFORMATION
, *PTRANSACTIONMANAGER_RECOVERY_INFORMATION
;
16139 typedef struct _TRANSACTION_PROPERTIES_INFORMATION
{
16140 ULONG IsolationLevel
;
16141 ULONG IsolationFlags
;
16142 LARGE_INTEGER Timeout
;
16144 ULONG DescriptionLength
;
16145 WCHAR Description
[1];
16146 } TRANSACTION_PROPERTIES_INFORMATION
, *PTRANSACTION_PROPERTIES_INFORMATION
;
16148 typedef struct _TRANSACTION_BIND_INFORMATION
{
16150 } TRANSACTION_BIND_INFORMATION
, *PTRANSACTION_BIND_INFORMATION
;
16152 typedef struct _TRANSACTION_ENLISTMENT_PAIR
{
16154 GUID ResourceManagerId
;
16155 } TRANSACTION_ENLISTMENT_PAIR
, *PTRANSACTION_ENLISTMENT_PAIR
;
16157 typedef struct _TRANSACTION_ENLISTMENTS_INFORMATION
{
16158 ULONG NumberOfEnlistments
;
16159 TRANSACTION_ENLISTMENT_PAIR EnlistmentPair
[1];
16160 } TRANSACTION_ENLISTMENTS_INFORMATION
, *PTRANSACTION_ENLISTMENTS_INFORMATION
;
16162 typedef struct _TRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION
{
16163 TRANSACTION_ENLISTMENT_PAIR SuperiorEnlistmentPair
;
16164 } TRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION
, *PTRANSACTION_SUPERIOR_ENLISTMENT_INFORMATION
;
16166 typedef struct _RESOURCEMANAGER_BASIC_INFORMATION
{
16167 GUID ResourceManagerId
;
16168 ULONG DescriptionLength
;
16169 WCHAR Description
[1];
16170 } RESOURCEMANAGER_BASIC_INFORMATION
, *PRESOURCEMANAGER_BASIC_INFORMATION
;
16172 typedef struct _RESOURCEMANAGER_COMPLETION_INFORMATION
{
16173 HANDLE IoCompletionPortHandle
;
16174 ULONG_PTR CompletionKey
;
16175 } RESOURCEMANAGER_COMPLETION_INFORMATION
, *PRESOURCEMANAGER_COMPLETION_INFORMATION
;
16177 typedef enum _KTMOBJECT_TYPE
{
16178 KTMOBJECT_TRANSACTION
,
16179 KTMOBJECT_TRANSACTION_MANAGER
,
16180 KTMOBJECT_RESOURCE_MANAGER
,
16181 KTMOBJECT_ENLISTMENT
,
16183 } KTMOBJECT_TYPE
, *PKTMOBJECT_TYPE
;
16185 typedef struct _KTMOBJECT_CURSOR
{
16187 ULONG ObjectIdCount
;
16189 } KTMOBJECT_CURSOR
, *PKTMOBJECT_CURSOR
;
16191 typedef enum _TRANSACTION_INFORMATION_CLASS
{
16192 TransactionBasicInformation
,
16193 TransactionPropertiesInformation
,
16194 TransactionEnlistmentInformation
,
16195 TransactionSuperiorEnlistmentInformation
16196 } TRANSACTION_INFORMATION_CLASS
;
16198 typedef enum _TRANSACTIONMANAGER_INFORMATION_CLASS
{
16199 TransactionManagerBasicInformation
,
16200 TransactionManagerLogInformation
,
16201 TransactionManagerLogPathInformation
,
16202 TransactionManagerRecoveryInformation
= 4
16203 } TRANSACTIONMANAGER_INFORMATION_CLASS
;
16205 typedef enum _RESOURCEMANAGER_INFORMATION_CLASS
{
16206 ResourceManagerBasicInformation
,
16207 ResourceManagerCompletionInformation
,
16208 } RESOURCEMANAGER_INFORMATION_CLASS
;
16210 typedef struct _ENLISTMENT_BASIC_INFORMATION
{
16212 GUID TransactionId
;
16213 GUID ResourceManagerId
;
16214 } ENLISTMENT_BASIC_INFORMATION
, *PENLISTMENT_BASIC_INFORMATION
;
16216 typedef struct _ENLISTMENT_CRM_INFORMATION
{
16217 GUID CrmTransactionManagerId
;
16218 GUID CrmResourceManagerId
;
16219 GUID CrmEnlistmentId
;
16220 } ENLISTMENT_CRM_INFORMATION
, *PENLISTMENT_CRM_INFORMATION
;
16222 typedef enum _ENLISTMENT_INFORMATION_CLASS
{
16223 EnlistmentBasicInformation
,
16224 EnlistmentRecoveryInformation
,
16225 EnlistmentCrmInformation
16226 } ENLISTMENT_INFORMATION_CLASS
;
16228 typedef struct _TRANSACTION_LIST_ENTRY
{
16229 #if defined(__cplusplus)
16234 } TRANSACTION_LIST_ENTRY
, *PTRANSACTION_LIST_ENTRY
;
16236 typedef struct _TRANSACTION_LIST_INFORMATION
{
16237 ULONG NumberOfTransactions
;
16238 TRANSACTION_LIST_ENTRY TransactionInformation
[1];
16239 } TRANSACTION_LIST_INFORMATION
, *PTRANSACTION_LIST_INFORMATION
;
16242 (NTAPI
*PFN_NT_CREATE_TRANSACTION
)(
16243 _Out_ PHANDLE TransactionHandle
,
16244 _In_ ACCESS_MASK DesiredAccess
,
16245 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
16246 _In_opt_ LPGUID Uow
,
16247 _In_opt_ HANDLE TmHandle
,
16248 _In_opt_ ULONG CreateOptions
,
16249 _In_opt_ ULONG IsolationLevel
,
16250 _In_opt_ ULONG IsolationFlags
,
16251 _In_opt_ PLARGE_INTEGER Timeout
,
16252 _In_opt_ PUNICODE_STRING Description
);
16255 (NTAPI
*PFN_NT_OPEN_TRANSACTION
)(
16256 _Out_ PHANDLE TransactionHandle
,
16257 _In_ ACCESS_MASK DesiredAccess
,
16258 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
16259 _In_opt_ LPGUID Uow
,
16260 _In_opt_ HANDLE TmHandle
);
16263 (NTAPI
*PFN_NT_QUERY_INFORMATION_TRANSACTION
)(
16264 _In_ HANDLE TransactionHandle
,
16265 _In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass
,
16266 _Out_writes_bytes_(TransactionInformationLength
) PVOID TransactionInformation
,
16267 _In_ ULONG TransactionInformationLength
,
16268 _Out_opt_ PULONG ReturnLength
);
16271 (NTAPI
*PFN_NT_SET_INFORMATION_TRANSACTION
)(
16272 _In_ HANDLE TransactionHandle
,
16273 _In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass
,
16274 _In_ PVOID TransactionInformation
,
16275 _In_ ULONG TransactionInformationLength
);
16278 (NTAPI
*PFN_NT_COMMIT_TRANSACTION
)(
16279 _In_ HANDLE TransactionHandle
,
16280 _In_ BOOLEAN Wait
);
16283 (NTAPI
*PFN_NT_ROLLBACK_TRANSACTION
)(
16284 _In_ HANDLE TransactionHandle
,
16285 _In_ BOOLEAN Wait
);
16287 #if (NTDDI_VERSION >= NTDDI_VISTA)
16289 _Must_inspect_result_
16290 _IRQL_requires_max_ (APC_LEVEL
)
16295 NtCreateTransactionManager(
16296 _Out_ PHANDLE TmHandle
,
16297 _In_ ACCESS_MASK DesiredAccess
,
16298 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
16299 _In_opt_ PUNICODE_STRING LogFileName
,
16300 _In_opt_ ULONG CreateOptions
,
16301 _In_opt_ ULONG CommitStrength
);
16303 _Must_inspect_result_
16304 _IRQL_requires_max_ (APC_LEVEL
)
16309 NtOpenTransactionManager(
16310 _Out_ PHANDLE TmHandle
,
16311 _In_ ACCESS_MASK DesiredAccess
,
16312 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
16313 _In_opt_ PUNICODE_STRING LogFileName
,
16314 _In_opt_ LPGUID TmIdentity
,
16315 _In_opt_ ULONG OpenOptions
);
16317 _Must_inspect_result_
16318 _IRQL_requires_max_ (APC_LEVEL
)
16323 NtRenameTransactionManager(
16324 _In_ PUNICODE_STRING LogFileName
,
16325 _In_ LPGUID ExistingTransactionManagerGuid
);
16327 _Must_inspect_result_
16328 _IRQL_requires_max_ (APC_LEVEL
)
16333 NtRollforwardTransactionManager(
16334 _In_ HANDLE TransactionManagerHandle
,
16335 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16337 _Must_inspect_result_
16338 _IRQL_requires_max_ (APC_LEVEL
)
16343 NtRecoverTransactionManager(
16344 _In_ HANDLE TransactionManagerHandle
);
16346 _Must_inspect_result_
16347 _IRQL_requires_max_ (APC_LEVEL
)
16352 NtQueryInformationTransactionManager(
16353 _In_ HANDLE TransactionManagerHandle
,
16354 _In_ TRANSACTIONMANAGER_INFORMATION_CLASS TransactionManagerInformationClass
,
16355 _Out_writes_bytes_(TransactionManagerInformationLength
) PVOID TransactionManagerInformation
,
16356 _In_ ULONG TransactionManagerInformationLength
,
16357 _Out_ PULONG ReturnLength
);
16359 _Must_inspect_result_
16360 _IRQL_requires_max_ (APC_LEVEL
)
16365 NtSetInformationTransactionManager(
16366 _In_opt_ HANDLE TmHandle
,
16367 _In_ TRANSACTIONMANAGER_INFORMATION_CLASS TransactionManagerInformationClass
,
16368 _In_reads_bytes_(TransactionManagerInformationLength
) PVOID TransactionManagerInformation
,
16369 _In_ ULONG TransactionManagerInformationLength
);
16371 _Must_inspect_result_
16372 _IRQL_requires_max_ (APC_LEVEL
)
16377 NtEnumerateTransactionObject(
16378 _In_opt_ HANDLE RootObjectHandle
,
16379 _In_ KTMOBJECT_TYPE QueryType
,
16380 _Inout_updates_bytes_(ObjectCursorLength
) PKTMOBJECT_CURSOR ObjectCursor
,
16381 _In_ ULONG ObjectCursorLength
,
16382 _Out_ PULONG ReturnLength
);
16384 _Must_inspect_result_
16385 _IRQL_requires_max_ (APC_LEVEL
)
16390 NtCreateTransaction(
16391 _Out_ PHANDLE TransactionHandle
,
16392 _In_ ACCESS_MASK DesiredAccess
,
16393 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
16394 _In_opt_ LPGUID Uow
,
16395 _In_opt_ HANDLE TmHandle
,
16396 _In_opt_ ULONG CreateOptions
,
16397 _In_opt_ ULONG IsolationLevel
,
16398 _In_opt_ ULONG IsolationFlags
,
16399 _In_opt_ PLARGE_INTEGER Timeout
,
16400 _In_opt_ PUNICODE_STRING Description
);
16402 _Must_inspect_result_
16403 _IRQL_requires_max_ (APC_LEVEL
)
16409 _Out_ PHANDLE TransactionHandle
,
16410 _In_ ACCESS_MASK DesiredAccess
,
16411 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
16413 _In_opt_ HANDLE TmHandle
);
16415 _Must_inspect_result_
16416 _IRQL_requires_max_ (APC_LEVEL
)
16421 NtQueryInformationTransaction(
16422 _In_ HANDLE TransactionHandle
,
16423 _In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass
,
16424 _Out_writes_bytes_(TransactionInformationLength
) PVOID TransactionInformation
,
16425 _In_ ULONG TransactionInformationLength
,
16426 _Out_opt_ PULONG ReturnLength
);
16428 _Must_inspect_result_
16429 _IRQL_requires_max_ (APC_LEVEL
)
16434 NtSetInformationTransaction(
16435 _In_ HANDLE TransactionHandle
,
16436 _In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass
,
16437 _In_reads_bytes_(TransactionInformationLength
) PVOID TransactionInformation
,
16438 _In_ ULONG TransactionInformationLength
);
16440 _IRQL_requires_max_ (APC_LEVEL
)
16445 NtCommitTransaction(
16446 _In_ HANDLE TransactionHandle
,
16447 _In_ BOOLEAN Wait
);
16449 _IRQL_requires_max_ (APC_LEVEL
)
16454 NtRollbackTransaction(
16455 _In_ HANDLE TransactionHandle
,
16456 _In_ BOOLEAN Wait
);
16458 _Must_inspect_result_
16459 _IRQL_requires_max_ (APC_LEVEL
)
16464 NtCreateEnlistment(
16465 _Out_ PHANDLE EnlistmentHandle
,
16466 _In_ ACCESS_MASK DesiredAccess
,
16467 _In_ HANDLE ResourceManagerHandle
,
16468 _In_ HANDLE TransactionHandle
,
16469 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
16470 _In_opt_ ULONG CreateOptions
,
16471 _In_ NOTIFICATION_MASK NotificationMask
,
16472 _In_opt_ PVOID EnlistmentKey
);
16474 _Must_inspect_result_
16475 _IRQL_requires_max_ (APC_LEVEL
)
16481 _Out_ PHANDLE EnlistmentHandle
,
16482 _In_ ACCESS_MASK DesiredAccess
,
16483 _In_ HANDLE ResourceManagerHandle
,
16484 _In_ LPGUID EnlistmentGuid
,
16485 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
);
16487 _Must_inspect_result_
16488 _IRQL_requires_max_ (APC_LEVEL
)
16493 NtQueryInformationEnlistment(
16494 _In_ HANDLE EnlistmentHandle
,
16495 _In_ ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass
,
16496 _Out_writes_bytes_(EnlistmentInformationLength
) PVOID EnlistmentInformation
,
16497 _In_ ULONG EnlistmentInformationLength
,
16498 _Out_ PULONG ReturnLength
);
16500 _Must_inspect_result_
16501 _IRQL_requires_max_ (APC_LEVEL
)
16506 NtSetInformationEnlistment(
16507 _In_opt_ HANDLE EnlistmentHandle
,
16508 _In_ ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass
,
16509 _In_reads_bytes_(EnlistmentInformationLength
) PVOID EnlistmentInformation
,
16510 _In_ ULONG EnlistmentInformationLength
);
16512 _Must_inspect_result_
16513 _IRQL_requires_max_ (APC_LEVEL
)
16518 NtRecoverEnlistment(
16519 _In_ HANDLE EnlistmentHandle
,
16520 _In_opt_ PVOID EnlistmentKey
);
16522 _Must_inspect_result_
16523 _IRQL_requires_max_ (APC_LEVEL
)
16528 NtPrePrepareEnlistment(
16529 _In_ HANDLE EnlistmentHandle
,
16530 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16532 _Must_inspect_result_
16533 _IRQL_requires_max_ (APC_LEVEL
)
16538 NtPrepareEnlistment(
16539 _In_ HANDLE EnlistmentHandle
,
16540 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16542 _Must_inspect_result_
16543 _IRQL_requires_max_ (APC_LEVEL
)
16548 NtCommitEnlistment(
16549 _In_ HANDLE EnlistmentHandle
,
16550 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16552 _IRQL_requires_max_ (APC_LEVEL
)
16557 NtRollbackEnlistment(
16558 _In_ HANDLE EnlistmentHandle
,
16559 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16561 _IRQL_requires_max_ (APC_LEVEL
)
16566 NtPrePrepareComplete(
16567 _In_ HANDLE EnlistmentHandle
,
16568 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16570 _IRQL_requires_max_ (APC_LEVEL
)
16576 _In_ HANDLE EnlistmentHandle
,
16577 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16579 _IRQL_requires_max_ (APC_LEVEL
)
16585 _In_ HANDLE EnlistmentHandle
,
16586 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16588 _IRQL_requires_max_ (APC_LEVEL
)
16593 NtReadOnlyEnlistment(
16594 _In_ HANDLE EnlistmentHandle
,
16595 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16597 _IRQL_requires_max_ (APC_LEVEL
)
16602 NtRollbackComplete(
16603 _In_ HANDLE EnlistmentHandle
,
16604 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16606 _IRQL_requires_max_ (APC_LEVEL
)
16611 NtSinglePhaseReject(
16612 _In_ HANDLE EnlistmentHandle
,
16613 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
16615 _Must_inspect_result_
16616 _IRQL_requires_max_ (APC_LEVEL
)
16621 NtCreateResourceManager(
16622 _Out_ PHANDLE ResourceManagerHandle
,
16623 _In_ ACCESS_MASK DesiredAccess
,
16624 _In_ HANDLE TmHandle
,
16625 _In_ LPGUID RmGuid
,
16626 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
16627 _In_opt_ ULONG CreateOptions
,
16628 _In_opt_ PUNICODE_STRING Description
);
16630 _Must_inspect_result_
16631 _IRQL_requires_max_ (APC_LEVEL
)
16636 NtOpenResourceManager(
16637 _Out_ PHANDLE ResourceManagerHandle
,
16638 _In_ ACCESS_MASK DesiredAccess
,
16639 _In_ HANDLE TmHandle
,
16640 _In_opt_ LPGUID ResourceManagerGuid
,
16641 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
);
16643 _Must_inspect_result_
16644 _IRQL_requires_max_ (APC_LEVEL
)
16649 NtRecoverResourceManager(
16650 _In_ HANDLE ResourceManagerHandle
);
16652 _Must_inspect_result_
16653 _IRQL_requires_max_ (APC_LEVEL
)
16658 NtGetNotificationResourceManager(
16659 _In_ HANDLE ResourceManagerHandle
,
16660 _Out_ PTRANSACTION_NOTIFICATION TransactionNotification
,
16661 _In_ ULONG NotificationLength
,
16662 _In_opt_ PLARGE_INTEGER Timeout
,
16663 _Out_opt_ PULONG ReturnLength
,
16664 _In_ ULONG Asynchronous
,
16665 _In_opt_ ULONG_PTR AsynchronousContext
);
16667 _Must_inspect_result_
16668 _IRQL_requires_max_ (APC_LEVEL
)
16673 NtQueryInformationResourceManager(
16674 _In_ HANDLE ResourceManagerHandle
,
16675 _In_ RESOURCEMANAGER_INFORMATION_CLASS ResourceManagerInformationClass
,
16676 _Out_writes_bytes_(ResourceManagerInformationLength
) PVOID ResourceManagerInformation
,
16677 _In_ ULONG ResourceManagerInformationLength
,
16678 _Out_opt_ PULONG ReturnLength
);
16680 _Must_inspect_result_
16681 _IRQL_requires_max_ (APC_LEVEL
)
16686 NtSetInformationResourceManager(
16687 _In_ HANDLE ResourceManagerHandle
,
16688 _In_ RESOURCEMANAGER_INFORMATION_CLASS ResourceManagerInformationClass
,
16689 _In_reads_bytes_(ResourceManagerInformationLength
) PVOID ResourceManagerInformation
,
16690 _In_ ULONG ResourceManagerInformationLength
);
16692 _Must_inspect_result_
16693 _IRQL_requires_max_ (APC_LEVEL
)
16698 NtRegisterProtocolAddressInformation(
16699 _In_ HANDLE ResourceManager
,
16700 _In_ PCRM_PROTOCOL_ID ProtocolId
,
16701 _In_ ULONG ProtocolInformationSize
,
16702 _In_ PVOID ProtocolInformation
,
16703 _In_opt_ ULONG CreateOptions
);
16705 _IRQL_requires_max_ (APC_LEVEL
)
16710 NtPropagationComplete(
16711 _In_ HANDLE ResourceManagerHandle
,
16712 _In_ ULONG RequestCookie
,
16713 _In_ ULONG BufferLength
,
16714 _In_ PVOID Buffer
);
16716 _IRQL_requires_max_ (APC_LEVEL
)
16721 NtPropagationFailed(
16722 _In_ HANDLE ResourceManagerHandle
,
16723 _In_ ULONG RequestCookie
,
16724 _In_ NTSTATUS PropStatus
);
16726 #endif /* NTDDI_VERSION >= NTDDI_VISTA */
16728 #endif /* !_NTTMAPI_ */
16729 /******************************************************************************
16730 * ZwXxx Functions *
16731 ******************************************************************************/
16735 #define NtCurrentProcess() ( (HANDLE)(LONG_PTR) -1 )
16736 #define ZwCurrentProcess() NtCurrentProcess()
16737 #define NtCurrentThread() ( (HANDLE)(LONG_PTR) -2 )
16738 #define ZwCurrentThread() NtCurrentThread()
16741 #if (NTDDI_VERSION >= NTDDI_WIN2K)
16743 _IRQL_requires_max_(PASSIVE_LEVEL
)
16748 _In_ HANDLE Handle
);
16750 _IRQL_requires_max_(PASSIVE_LEVEL
)
16754 ZwCreateDirectoryObject(
16755 _Out_ PHANDLE DirectoryHandle
,
16756 _In_ ACCESS_MASK DesiredAccess
,
16757 _In_ POBJECT_ATTRIBUTES ObjectAttributes
);
16759 _IRQL_requires_max_(PASSIVE_LEVEL
)
16764 _Out_ PHANDLE FileHandle
,
16765 _In_ ACCESS_MASK DesiredAccess
,
16766 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
16767 _Out_ PIO_STATUS_BLOCK IoStatusBlock
,
16768 _In_opt_ PLARGE_INTEGER AllocationSize
,
16769 _In_ ULONG FileAttributes
,
16770 _In_ ULONG ShareAccess
,
16771 _In_ ULONG CreateDisposition
,
16772 _In_ ULONG CreateOptions
,
16773 _In_reads_bytes_opt_(EaLength
) PVOID EaBuffer
,
16774 _In_ ULONG EaLength
16777 _IRQL_requires_max_(PASSIVE_LEVEL
)
16782 _Out_ PHANDLE KeyHandle
,
16783 _In_ ACCESS_MASK DesiredAccess
,
16784 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
16785 _Reserved_ ULONG TitleIndex
,
16786 _In_opt_ PUNICODE_STRING Class
,
16787 _In_ ULONG CreateOptions
,
16788 _Out_opt_ PULONG Disposition
);
16790 _IRQL_requires_max_(APC_LEVEL
)
16795 _Out_ PHANDLE SectionHandle
,
16796 _In_ ACCESS_MASK DesiredAccess
,
16797 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
16798 _In_opt_ PLARGE_INTEGER MaximumSize
,
16799 _In_ ULONG SectionPageProtection
,
16800 _In_ ULONG AllocationAttributes
,
16801 _In_opt_ HANDLE FileHandle
);
16803 _IRQL_requires_max_(PASSIVE_LEVEL
)
16808 _In_ HANDLE KeyHandle
);
16810 _IRQL_requires_max_(PASSIVE_LEVEL
)
16815 _In_ HANDLE KeyHandle
,
16816 _In_ PUNICODE_STRING ValueName
);
16818 _IRQL_requires_max_(PASSIVE_LEVEL
)
16819 _When_(Length
== 0, _Post_satisfies_(return < 0))
16820 _When_(Length
> 0, _Post_satisfies_(return <= 0))
16825 _In_ HANDLE KeyHandle
,
16827 _In_ KEY_INFORMATION_CLASS KeyInformationClass
,
16828 _Out_writes_bytes_opt_(Length
) PVOID KeyInformation
,
16830 _Out_ PULONG ResultLength
);
16832 _IRQL_requires_max_(PASSIVE_LEVEL
)
16833 _When_(Length
== 0, _Post_satisfies_(return < 0))
16834 _When_(Length
> 0, _Post_satisfies_(return <= 0))
16838 ZwEnumerateValueKey(
16839 _In_ HANDLE KeyHandle
,
16841 _In_ KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass
,
16842 _Out_writes_bytes_opt_(Length
) PVOID KeyValueInformation
,
16844 _Out_ PULONG ResultLength
);
16846 _IRQL_requires_max_(PASSIVE_LEVEL
)
16851 _In_ HANDLE KeyHandle
);
16853 _IRQL_requires_max_(PASSIVE_LEVEL
)
16858 _In_ PUNICODE_STRING DriverServiceName
);
16860 _IRQL_requires_max_(PASSIVE_LEVEL
)
16864 ZwMakeTemporaryObject(
16865 _In_ HANDLE Handle
);
16867 _IRQL_requires_max_(PASSIVE_LEVEL
)
16871 ZwMapViewOfSection(
16872 _In_ HANDLE SectionHandle
,
16873 _In_ HANDLE ProcessHandle
,
16874 _Outptr_result_bytebuffer_(*ViewSize
) PVOID
*BaseAddress
,
16875 _In_ ULONG_PTR ZeroBits
,
16876 _In_ SIZE_T CommitSize
,
16877 _Inout_opt_ PLARGE_INTEGER SectionOffset
,
16878 _Inout_ PSIZE_T ViewSize
,
16879 _In_ SECTION_INHERIT InheritDisposition
,
16880 _In_ ULONG AllocationType
,
16881 _In_ ULONG Protect
);
16883 _IRQL_requires_max_(PASSIVE_LEVEL
)
16888 _Out_ PHANDLE FileHandle
,
16889 _In_ ACCESS_MASK DesiredAccess
,
16890 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
16891 _Out_ PIO_STATUS_BLOCK IoStatusBlock
,
16892 _In_ ULONG ShareAccess
,
16893 _In_ ULONG OpenOptions
);
16895 _IRQL_requires_max_(PASSIVE_LEVEL
)
16900 _Out_ PHANDLE KeyHandle
,
16901 _In_ ACCESS_MASK DesiredAccess
,
16902 _In_ POBJECT_ATTRIBUTES ObjectAttributes
);
16904 _IRQL_requires_max_(PASSIVE_LEVEL
)
16909 _Out_ PHANDLE SectionHandle
,
16910 _In_ ACCESS_MASK DesiredAccess
,
16911 _In_ POBJECT_ATTRIBUTES ObjectAttributes
);
16913 _IRQL_requires_max_(PASSIVE_LEVEL
)
16917 ZwOpenSymbolicLinkObject(
16918 _Out_ PHANDLE LinkHandle
,
16919 _In_ ACCESS_MASK DesiredAccess
,
16920 _In_ POBJECT_ATTRIBUTES ObjectAttributes
);
16922 _IRQL_requires_max_(PASSIVE_LEVEL
)
16926 ZwQueryInformationFile(
16927 _In_ HANDLE FileHandle
,
16928 _Out_ PIO_STATUS_BLOCK IoStatusBlock
,
16929 _Out_writes_bytes_(Length
) PVOID FileInformation
,
16931 _In_ FILE_INFORMATION_CLASS FileInformationClass
);
16933 _IRQL_requires_max_(PASSIVE_LEVEL
)
16934 _When_(Length
== 0, _Post_satisfies_(return < 0))
16935 _When_(Length
> 0, _Post_satisfies_(return <= 0))
16940 _In_ HANDLE KeyHandle
,
16941 _In_ KEY_INFORMATION_CLASS KeyInformationClass
,
16942 _Out_writes_bytes_opt_(Length
) PVOID KeyInformation
,
16944 _Out_ PULONG ResultLength
);
16946 _IRQL_requires_max_(PASSIVE_LEVEL
)
16950 ZwQuerySymbolicLinkObject(
16951 _In_ HANDLE LinkHandle
,
16952 _Inout_ PUNICODE_STRING LinkTarget
,
16953 _Out_opt_ PULONG ReturnedLength
);
16955 _IRQL_requires_max_(PASSIVE_LEVEL
)
16956 _When_(Length
== 0, _Post_satisfies_(return < 0))
16957 _When_(Length
> 0, _Post_satisfies_(return <= 0))
16962 _In_ HANDLE KeyHandle
,
16963 _In_ PUNICODE_STRING ValueName
,
16964 _In_ KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass
,
16965 _Out_writes_bytes_opt_(Length
) PVOID KeyValueInformation
,
16967 _Out_ PULONG ResultLength
);
16969 _IRQL_requires_max_(PASSIVE_LEVEL
)
16974 _In_ HANDLE FileHandle
,
16975 _In_opt_ HANDLE Event
,
16976 _In_opt_ PIO_APC_ROUTINE ApcRoutine
,
16977 _In_opt_ PVOID ApcContext
,
16978 _Out_ PIO_STATUS_BLOCK IoStatusBlock
,
16979 _Out_writes_bytes_(Length
) PVOID Buffer
,
16981 _In_opt_ PLARGE_INTEGER ByteOffset
,
16982 _In_opt_ PULONG Key
);
16984 _IRQL_requires_max_(PASSIVE_LEVEL
)
16988 ZwSetInformationFile(
16989 _In_ HANDLE FileHandle
,
16990 _Out_ PIO_STATUS_BLOCK IoStatusBlock
,
16991 _In_reads_bytes_(Length
) PVOID FileInformation
,
16993 _In_ FILE_INFORMATION_CLASS FileInformationClass
);
16995 _IRQL_requires_max_(PASSIVE_LEVEL
)
17000 _In_ HANDLE KeyHandle
,
17001 _In_ PUNICODE_STRING ValueName
,
17002 _In_opt_ ULONG TitleIndex
,
17004 _In_reads_bytes_opt_(DataSize
) PVOID Data
,
17005 _In_ ULONG DataSize
);
17007 _IRQL_requires_max_(PASSIVE_LEVEL
)
17012 _In_ PUNICODE_STRING DriverServiceName
);
17014 _IRQL_requires_max_(PASSIVE_LEVEL
)
17018 ZwUnmapViewOfSection(
17019 _In_ HANDLE ProcessHandle
,
17020 _In_opt_ PVOID BaseAddress
);
17022 _IRQL_requires_max_(PASSIVE_LEVEL
)
17027 _In_ HANDLE FileHandle
,
17028 _In_opt_ HANDLE Event
,
17029 _In_opt_ PIO_APC_ROUTINE ApcRoutine
,
17030 _In_opt_ PVOID ApcContext
,
17031 _Out_ PIO_STATUS_BLOCK IoStatusBlock
,
17032 _In_reads_bytes_(Length
) PVOID Buffer
,
17034 _In_opt_ PLARGE_INTEGER ByteOffset
,
17035 _In_opt_ PULONG Key
);
17037 _IRQL_requires_max_(PASSIVE_LEVEL
)
17041 ZwQueryFullAttributesFile(
17042 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
17043 _Out_ PFILE_NETWORK_OPEN_INFORMATION FileInformation
);
17045 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
17048 #if (NTDDI_VERSION >= NTDDI_WS03)
17049 _IRQL_requires_max_(PASSIVE_LEVEL
)
17054 _Out_ PHANDLE EventHandle
,
17055 _In_ ACCESS_MASK DesiredAccess
,
17056 _In_ POBJECT_ATTRIBUTES ObjectAttributes
);
17059 #if (NTDDI_VERSION >= NTDDI_VISTA)
17061 _IRQL_requires_max_(PASSIVE_LEVEL
)
17064 ZwCreateKeyTransacted(
17065 _Out_ PHANDLE KeyHandle
,
17066 _In_ ACCESS_MASK DesiredAccess
,
17067 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
17068 _Reserved_ ULONG TitleIndex
,
17069 _In_opt_ PUNICODE_STRING Class
,
17070 _In_ ULONG CreateOptions
,
17071 _In_ HANDLE TransactionHandle
,
17072 _Out_opt_ PULONG Disposition
);
17074 _IRQL_requires_max_(PASSIVE_LEVEL
)
17078 ZwOpenKeyTransacted(
17079 _Out_ PHANDLE KeyHandle
,
17080 _In_ ACCESS_MASK DesiredAccess
,
17081 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
17082 _In_ HANDLE TransactionHandle
);
17084 _IRQL_requires_max_(PASSIVE_LEVEL
)
17088 ZwCreateTransactionManager(
17089 _Out_ PHANDLE TmHandle
,
17090 _In_ ACCESS_MASK DesiredAccess
,
17091 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
17092 _In_opt_ PUNICODE_STRING LogFileName
,
17093 _In_opt_ ULONG CreateOptions
,
17094 _In_opt_ ULONG CommitStrength
);
17096 _IRQL_requires_max_(PASSIVE_LEVEL
)
17100 ZwOpenTransactionManager(
17101 _Out_ PHANDLE TmHandle
,
17102 _In_ ACCESS_MASK DesiredAccess
,
17103 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
17104 _In_opt_ PUNICODE_STRING LogFileName
,
17105 _In_opt_ LPGUID TmIdentity
,
17106 _In_opt_ ULONG OpenOptions
);
17108 _IRQL_requires_max_(PASSIVE_LEVEL
)
17112 ZwRollforwardTransactionManager(
17113 _In_ HANDLE TransactionManagerHandle
,
17114 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17116 _IRQL_requires_max_(PASSIVE_LEVEL
)
17120 ZwRecoverTransactionManager(
17121 _In_ HANDLE TransactionManagerHandle
);
17123 _IRQL_requires_max_(PASSIVE_LEVEL
)
17127 ZwQueryInformationTransactionManager(
17128 _In_ HANDLE TransactionManagerHandle
,
17129 _In_ TRANSACTIONMANAGER_INFORMATION_CLASS TransactionManagerInformationClass
,
17130 _Out_writes_bytes_(TransactionManagerInformationLength
) PVOID TransactionManagerInformation
,
17131 _In_ ULONG TransactionManagerInformationLength
,
17132 _Out_opt_ PULONG ReturnLength
);
17134 _IRQL_requires_max_(PASSIVE_LEVEL
)
17138 ZwSetInformationTransactionManager(
17139 _In_ HANDLE TmHandle
,
17140 _In_ TRANSACTIONMANAGER_INFORMATION_CLASS TransactionManagerInformationClass
,
17141 _In_ PVOID TransactionManagerInformation
,
17142 _In_ ULONG TransactionManagerInformationLength
);
17144 _IRQL_requires_max_(PASSIVE_LEVEL
)
17148 ZwEnumerateTransactionObject(
17149 _In_opt_ HANDLE RootObjectHandle
,
17150 _In_ KTMOBJECT_TYPE QueryType
,
17151 _Inout_updates_bytes_(ObjectCursorLength
) PKTMOBJECT_CURSOR ObjectCursor
,
17152 _In_ ULONG ObjectCursorLength
,
17153 _Out_ PULONG ReturnLength
);
17155 _IRQL_requires_max_(PASSIVE_LEVEL
)
17159 ZwCreateTransaction(
17160 _Out_ PHANDLE TransactionHandle
,
17161 _In_ ACCESS_MASK DesiredAccess
,
17162 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
17163 _In_opt_ LPGUID Uow
,
17164 _In_opt_ HANDLE TmHandle
,
17165 _In_opt_ ULONG CreateOptions
,
17166 _In_opt_ ULONG IsolationLevel
,
17167 _In_opt_ ULONG IsolationFlags
,
17168 _In_opt_ PLARGE_INTEGER Timeout
,
17169 _In_opt_ PUNICODE_STRING Description
);
17171 _IRQL_requires_max_(PASSIVE_LEVEL
)
17176 _Out_ PHANDLE TransactionHandle
,
17177 _In_ ACCESS_MASK DesiredAccess
,
17178 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
17180 _In_opt_ HANDLE TmHandle
);
17182 _IRQL_requires_max_(PASSIVE_LEVEL
)
17186 ZwQueryInformationTransaction(
17187 _In_ HANDLE TransactionHandle
,
17188 _In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass
,
17189 _Out_writes_bytes_(TransactionInformationLength
) PVOID TransactionInformation
,
17190 _In_ ULONG TransactionInformationLength
,
17191 _Out_opt_ PULONG ReturnLength
);
17193 _IRQL_requires_max_(PASSIVE_LEVEL
)
17197 ZwSetInformationTransaction(
17198 _In_ HANDLE TransactionHandle
,
17199 _In_ TRANSACTION_INFORMATION_CLASS TransactionInformationClass
,
17200 _In_ PVOID TransactionInformation
,
17201 _In_ ULONG TransactionInformationLength
);
17203 _IRQL_requires_max_(PASSIVE_LEVEL
)
17207 ZwCommitTransaction(
17208 _In_ HANDLE TransactionHandle
,
17209 _In_ BOOLEAN Wait
);
17211 _IRQL_requires_max_(PASSIVE_LEVEL
)
17215 ZwRollbackTransaction(
17216 _In_ HANDLE TransactionHandle
,
17217 _In_ BOOLEAN Wait
);
17219 _IRQL_requires_max_(PASSIVE_LEVEL
)
17223 ZwCreateResourceManager(
17224 _Out_ PHANDLE ResourceManagerHandle
,
17225 _In_ ACCESS_MASK DesiredAccess
,
17226 _In_ HANDLE TmHandle
,
17227 _In_opt_ LPGUID ResourceManagerGuid
,
17228 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
17229 _In_opt_ ULONG CreateOptions
,
17230 _In_opt_ PUNICODE_STRING Description
);
17232 _IRQL_requires_max_(PASSIVE_LEVEL
)
17236 ZwOpenResourceManager(
17237 _Out_ PHANDLE ResourceManagerHandle
,
17238 _In_ ACCESS_MASK DesiredAccess
,
17239 _In_ HANDLE TmHandle
,
17240 _In_ LPGUID ResourceManagerGuid
,
17241 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
);
17243 _IRQL_requires_max_(PASSIVE_LEVEL
)
17247 ZwRecoverResourceManager(
17248 _In_ HANDLE ResourceManagerHandle
);
17250 _IRQL_requires_max_(PASSIVE_LEVEL
)
17254 ZwGetNotificationResourceManager(
17255 _In_ HANDLE ResourceManagerHandle
,
17256 _Out_ PTRANSACTION_NOTIFICATION TransactionNotification
,
17257 _In_ ULONG NotificationLength
,
17258 _In_ PLARGE_INTEGER Timeout
,
17259 _Out_opt_ PULONG ReturnLength
,
17260 _In_ ULONG Asynchronous
,
17261 _In_opt_ ULONG_PTR AsynchronousContext
);
17263 _IRQL_requires_max_(PASSIVE_LEVEL
)
17267 ZwQueryInformationResourceManager(
17268 _In_ HANDLE ResourceManagerHandle
,
17269 _In_ RESOURCEMANAGER_INFORMATION_CLASS ResourceManagerInformationClass
,
17270 _Out_writes_bytes_(ResourceManagerInformationLength
) PVOID ResourceManagerInformation
,
17271 _In_ ULONG ResourceManagerInformationLength
,
17272 _Out_opt_ PULONG ReturnLength
);
17274 _IRQL_requires_max_(PASSIVE_LEVEL
)
17278 ZwSetInformationResourceManager(
17279 _In_ HANDLE ResourceManagerHandle
,
17280 _In_ RESOURCEMANAGER_INFORMATION_CLASS ResourceManagerInformationClass
,
17281 _In_reads_bytes_(ResourceManagerInformationLength
) PVOID ResourceManagerInformation
,
17282 _In_ ULONG ResourceManagerInformationLength
);
17284 _IRQL_requires_max_(PASSIVE_LEVEL
)
17288 ZwCreateEnlistment(
17289 _Out_ PHANDLE EnlistmentHandle
,
17290 _In_ ACCESS_MASK DesiredAccess
,
17291 _In_ HANDLE ResourceManagerHandle
,
17292 _In_ HANDLE TransactionHandle
,
17293 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
,
17294 _In_opt_ ULONG CreateOptions
,
17295 _In_ NOTIFICATION_MASK NotificationMask
,
17296 _In_opt_ PVOID EnlistmentKey
);
17298 _IRQL_requires_max_(PASSIVE_LEVEL
)
17303 _Out_ PHANDLE EnlistmentHandle
,
17304 _In_ ACCESS_MASK DesiredAccess
,
17305 _In_ HANDLE RmHandle
,
17306 _In_ LPGUID EnlistmentGuid
,
17307 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes
);
17309 _IRQL_requires_max_(PASSIVE_LEVEL
)
17313 ZwQueryInformationEnlistment(
17314 _In_ HANDLE EnlistmentHandle
,
17315 _In_ ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass
,
17316 _Out_writes_bytes_(EnlistmentInformationLength
) PVOID EnlistmentInformation
,
17317 _In_ ULONG EnlistmentInformationLength
,
17318 _Out_opt_ PULONG ReturnLength
);
17320 _IRQL_requires_max_(PASSIVE_LEVEL
)
17324 ZwSetInformationEnlistment(
17325 _In_ HANDLE EnlistmentHandle
,
17326 _In_ ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass
,
17327 _In_reads_bytes_(EnlistmentInformationLength
) PVOID EnlistmentInformation
,
17328 _In_ ULONG EnlistmentInformationLength
);
17330 _IRQL_requires_max_(PASSIVE_LEVEL
)
17334 ZwRecoverEnlistment(
17335 _In_ HANDLE EnlistmentHandle
,
17336 _In_opt_ PVOID EnlistmentKey
);
17338 _IRQL_requires_max_(PASSIVE_LEVEL
)
17342 ZwPrePrepareEnlistment(
17343 _In_ HANDLE EnlistmentHandle
,
17344 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17346 _IRQL_requires_max_(PASSIVE_LEVEL
)
17350 ZwPrepareEnlistment(
17351 _In_ HANDLE EnlistmentHandle
,
17352 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17354 _IRQL_requires_max_(PASSIVE_LEVEL
)
17358 ZwCommitEnlistment(
17359 _In_ HANDLE EnlistmentHandle
,
17360 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17362 _IRQL_requires_max_(PASSIVE_LEVEL
)
17366 ZwRollbackEnlistment(
17367 _In_ HANDLE EnlistmentHandle
,
17368 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17370 _IRQL_requires_max_(PASSIVE_LEVEL
)
17374 ZwPrePrepareComplete(
17375 _In_ HANDLE EnlistmentHandle
,
17376 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17378 _IRQL_requires_max_(PASSIVE_LEVEL
)
17383 _In_ HANDLE EnlistmentHandle
,
17384 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17386 _IRQL_requires_max_(PASSIVE_LEVEL
)
17391 _In_ HANDLE EnlistmentHandle
,
17392 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17394 _IRQL_requires_max_(PASSIVE_LEVEL
)
17398 ZwReadOnlyEnlistment(
17399 _In_ HANDLE EnlistmentHandle
,
17400 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17405 ZwRollbackComplete(
17406 _In_ HANDLE EnlistmentHandle
,
17407 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17412 ZwSinglePhaseReject(
17413 _In_ HANDLE EnlistmentHandle
,
17414 _In_opt_ PLARGE_INTEGER TmVirtualClock
);
17415 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
17416 #if (NTDDI_VERSION >= NTDDI_WIN7)
17418 _IRQL_requires_max_(PASSIVE_LEVEL
)
17423 _Out_ PHANDLE KeyHandle
,
17424 _In_ ACCESS_MASK DesiredAccess
,
17425 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
17426 _In_ ULONG OpenOptions
);
17428 _IRQL_requires_max_(PASSIVE_LEVEL
)
17432 ZwOpenKeyTransactedEx(
17433 _Out_ PHANDLE KeyHandle
,
17434 _In_ ACCESS_MASK DesiredAccess
,
17435 _In_ POBJECT_ATTRIBUTES ObjectAttributes
,
17436 _In_ ULONG OpenOptions
,
17437 _In_ HANDLE TransactionHandle
);
17442 ZwNotifyChangeMultipleKeys(
17443 _In_ HANDLE MasterKeyHandle
,
17444 _In_opt_ ULONG Count
,
17445 _In_opt_ OBJECT_ATTRIBUTES SubordinateObjects
[],
17446 _In_opt_ HANDLE Event
,
17447 _In_opt_ PIO_APC_ROUTINE ApcRoutine
,
17448 _In_opt_ PVOID ApcContext
,
17449 _Out_ PIO_STATUS_BLOCK IoStatusBlock
,
17450 _In_ ULONG CompletionFilter
,
17451 _In_ BOOLEAN WatchTree
,
17452 _Out_opt_ PVOID Buffer
,
17453 _In_ ULONG BufferSize
,
17454 _In_ BOOLEAN Asynchronous
);
17459 ZwQueryMultipleValueKey(
17460 _In_ HANDLE KeyHandle
,
17461 _Inout_ PKEY_VALUE_ENTRY ValueEntries
,
17462 _In_ ULONG EntryCount
,
17463 _Out_ PVOID ValueBuffer
,
17464 _Inout_ PULONG BufferLength
,
17465 _Out_opt_ PULONG RequiredBufferLength
);
17467 _IRQL_requires_max_(PASSIVE_LEVEL
)
17472 _In_ HANDLE KeyHandle
,
17473 _In_ PUNICODE_STRING NewName
);
17475 _IRQL_requires_max_(PASSIVE_LEVEL
)
17479 ZwSetInformationKey(
17480 _In_ HANDLE KeyHandle
,
17481 _In_
__drv_strictTypeMatch(__drv_typeConst
) KEY_SET_INFORMATION_CLASS KeySetInformationClass
,
17482 _In_reads_bytes_(KeySetInformationLength
) PVOID KeySetInformation
,
17483 _In_ ULONG KeySetInformationLength
);
17485 #endif /* (NTDDI_VERSION >= NTDDI_WIN7) */
17492 #endif /* !_WDMDDK_ */