[SDK][NDK] Move SYSTEM_POWER_INFORMATION to ntpoapi.h (#869)
[reactos.git] / sdk / include / xdk / psfuncs.h
1 /******************************************************************************
2 * Process Manager Functions *
3 ******************************************************************************/
4 $if (_WDMDDK_)
5
6 NTKERNELAPI
7 NTSTATUS
8 NTAPI
9 PsWrapApcWow64Thread(
10 _Inout_ PVOID *ApcContext,
11 _Inout_ PVOID *ApcRoutine);
12
13 /*
14 * PEPROCESS
15 * PsGetCurrentProcess(VOID)
16 */
17 #define PsGetCurrentProcess IoGetCurrentProcess
18
19 #if !defined(_PSGETCURRENTTHREAD_)
20 #define _PSGETCURRENTTHREAD_
21 _IRQL_requires_max_(DISPATCH_LEVEL)
22 FORCEINLINE
23 PETHREAD
24 NTAPI
25 PsGetCurrentThread(VOID)
26 {
27 return (PETHREAD)KeGetCurrentThread();
28 }
29 #endif /* !_PSGETCURRENTTHREAD_ */
30
31 $endif (_WDMDDK_)
32 $if (_NTDDK_)
33
34 __kernel_entry
35 NTSYSCALLAPI
36 NTSTATUS
37 NTAPI
38 NtOpenProcess(
39 _Out_ PHANDLE ProcessHandle,
40 _In_ ACCESS_MASK DesiredAccess,
41 _In_ POBJECT_ATTRIBUTES ObjectAttributes,
42 _In_opt_ PCLIENT_ID ClientId);
43
44 __kernel_entry
45 NTSYSCALLAPI
46 NTSTATUS
47 NTAPI
48 NtQueryInformationProcess(
49 _In_ HANDLE ProcessHandle,
50 _In_ PROCESSINFOCLASS ProcessInformationClass,
51 _Out_ PVOID ProcessInformation,
52 _In_ ULONG ProcessInformationLength,
53 _Out_opt_ PULONG ReturnLength);
54 $endif (_NTDDK_)
55 $if (_NTIFS_)
56
57 _Must_inspect_result_
58 _IRQL_requires_max_(APC_LEVEL)
59 NTKERNELAPI
60 NTSTATUS
61 NTAPI
62 PsLookupProcessByProcessId(
63 _In_ HANDLE ProcessId,
64 _Outptr_ PEPROCESS *Process);
65
66 _Must_inspect_result_
67 _IRQL_requires_max_(APC_LEVEL)
68 NTKERNELAPI
69 NTSTATUS
70 NTAPI
71 PsLookupThreadByThreadId(
72 _In_ HANDLE UniqueThreadId,
73 _Outptr_ PETHREAD *Thread);
74 $endif (_NTIFS_)
75
76 #if (NTDDI_VERSION >= NTDDI_WIN2K)
77
78 $if (_WDMDDK_)
79 _IRQL_requires_max_(APC_LEVEL)
80 _Post_satisfies_(return <= 0)
81 _Must_inspect_result_
82 NTKERNELAPI
83 NTSTATUS
84 NTAPI
85 PsCreateSystemThread(
86 _Out_ PHANDLE ThreadHandle,
87 _In_ ULONG DesiredAccess,
88 _In_opt_ POBJECT_ATTRIBUTES ObjectAttributes,
89 _In_opt_ HANDLE ProcessHandle,
90 _Out_opt_ PCLIENT_ID ClientId,
91 _In_ PKSTART_ROUTINE StartRoutine,
92 _In_opt_ _When_(return==0, __drv_aliasesMem) PVOID StartContext);
93
94 _IRQL_requires_max_(PASSIVE_LEVEL)
95 NTKERNELAPI
96 NTSTATUS
97 NTAPI
98 PsTerminateSystemThread(
99 _In_ NTSTATUS ExitStatus);
100
101 $endif (_WDMDDK_)
102 $if (_NTDDK_)
103
104 _IRQL_requires_max_(PASSIVE_LEVEL)
105 NTKERNELAPI
106 NTSTATUS
107 NTAPI
108 PsSetCreateProcessNotifyRoutine(
109 _In_ PCREATE_PROCESS_NOTIFY_ROUTINE NotifyRoutine,
110 _In_ BOOLEAN Remove);
111
112 _IRQL_requires_max_(PASSIVE_LEVEL)
113 NTKERNELAPI
114 NTSTATUS
115 NTAPI
116 PsSetCreateThreadNotifyRoutine(
117 _In_ PCREATE_THREAD_NOTIFY_ROUTINE NotifyRoutine);
118
119 _IRQL_requires_max_(PASSIVE_LEVEL)
120 NTKERNELAPI
121 NTSTATUS
122 NTAPI
123 PsSetLoadImageNotifyRoutine(
124 _In_ PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine);
125
126 NTKERNELAPI
127 HANDLE
128 NTAPI
129 PsGetCurrentProcessId(VOID);
130
131 _IRQL_requires_max_(DISPATCH_LEVEL)
132 NTKERNELAPI
133 HANDLE
134 NTAPI
135 PsGetCurrentThreadId(VOID);
136
137 NTKERNELAPI
138 BOOLEAN
139 NTAPI
140 PsGetVersion(
141 OUT PULONG MajorVersion OPTIONAL,
142 OUT PULONG MinorVersion OPTIONAL,
143 OUT PULONG BuildNumber OPTIONAL,
144 OUT PUNICODE_STRING CSDVersion OPTIONAL);
145 $endif (_NTDDK_)
146 $if (_NTIFS_)
147
148 _IRQL_requires_max_(APC_LEVEL)
149 NTKERNELAPI
150 PACCESS_TOKEN
151 NTAPI
152 PsReferenceImpersonationToken(
153 _Inout_ PETHREAD Thread,
154 _Out_ PBOOLEAN CopyOnOpen,
155 _Out_ PBOOLEAN EffectiveOnly,
156 _Out_ PSECURITY_IMPERSONATION_LEVEL ImpersonationLevel);
157
158 _IRQL_requires_max_(APC_LEVEL)
159 NTKERNELAPI
160 LARGE_INTEGER
161 NTAPI
162 PsGetProcessExitTime(VOID);
163
164 _IRQL_requires_max_(DISPATCH_LEVEL)
165 NTKERNELAPI
166 BOOLEAN
167 NTAPI
168 PsIsThreadTerminating(
169 _In_ PETHREAD Thread);
170
171 _Must_inspect_result_
172 _IRQL_requires_max_(PASSIVE_LEVEL)
173 NTKERNELAPI
174 NTSTATUS
175 NTAPI
176 PsImpersonateClient(
177 _Inout_ PETHREAD Thread,
178 _In_opt_ PACCESS_TOKEN Token,
179 _In_ BOOLEAN CopyOnOpen,
180 _In_ BOOLEAN EffectiveOnly,
181 _In_ SECURITY_IMPERSONATION_LEVEL ImpersonationLevel);
182
183 _IRQL_requires_max_(PASSIVE_LEVEL)
184 NTKERNELAPI
185 BOOLEAN
186 NTAPI
187 PsDisableImpersonation(
188 _Inout_ PETHREAD Thread,
189 _Inout_ PSE_IMPERSONATION_STATE ImpersonationState);
190
191 _IRQL_requires_max_(PASSIVE_LEVEL)
192 NTKERNELAPI
193 VOID
194 NTAPI
195 PsRestoreImpersonation(
196 _Inout_ PETHREAD Thread,
197 _In_ PSE_IMPERSONATION_STATE ImpersonationState);
198
199 _IRQL_requires_max_(PASSIVE_LEVEL)
200 NTKERNELAPI
201 VOID
202 NTAPI
203 PsRevertToSelf(VOID);
204
205 _IRQL_requires_max_(APC_LEVEL)
206 NTKERNELAPI
207 VOID
208 NTAPI
209 PsChargePoolQuota(
210 _In_ PEPROCESS Process,
211 _In_ POOL_TYPE PoolType,
212 _In_ ULONG_PTR Amount);
213
214 _IRQL_requires_max_(APC_LEVEL)
215 NTKERNELAPI
216 VOID
217 NTAPI
218 PsReturnPoolQuota(
219 _In_ PEPROCESS Process,
220 _In_ POOL_TYPE PoolType,
221 _In_ ULONG_PTR Amount);
222
223 _IRQL_requires_max_(PASSIVE_LEVEL)
224 NTKERNELAPI
225 NTSTATUS
226 NTAPI
227 PsAssignImpersonationToken(
228 _In_ PETHREAD Thread,
229 _In_opt_ HANDLE Token);
230
231 _IRQL_requires_max_(PASSIVE_LEVEL)
232 NTKERNELAPI
233 HANDLE
234 NTAPI
235 PsReferencePrimaryToken(
236 _Inout_ PEPROCESS Process);
237 $endif (_NTIFS_)
238 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
239 $if (_NTDDK_ || _NTIFS_)
240 #if (NTDDI_VERSION >= NTDDI_WINXP)
241 $endif (_NTDDK_ || _NTIFS_)
242
243 $if (_NTDDK_)
244 _IRQL_requires_max_(DISPATCH_LEVEL)
245 NTKERNELAPI
246 HANDLE
247 NTAPI
248 PsGetProcessId(
249 _In_ PEPROCESS Process);
250
251 _IRQL_requires_max_(DISPATCH_LEVEL)
252 NTKERNELAPI
253 HANDLE
254 NTAPI
255 PsGetThreadId(
256 _In_ PETHREAD Thread);
257
258 NTKERNELAPI
259 PEPROCESS
260 NTAPI
261 PsGetThreadProcess(
262 _In_ PETHREAD Thread
263 );
264
265 NTKERNELAPI
266 NTSTATUS
267 NTAPI
268 PsRemoveCreateThreadNotifyRoutine(
269 _In_ PCREATE_THREAD_NOTIFY_ROUTINE NotifyRoutine);
270
271 _IRQL_requires_max_(PASSIVE_LEVEL)
272 NTKERNELAPI
273 NTSTATUS
274 NTAPI
275 PsRemoveLoadImageNotifyRoutine(
276 _In_ PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine);
277
278 _IRQL_requires_max_(DISPATCH_LEVEL)
279 NTKERNELAPI
280 LONGLONG
281 NTAPI
282 PsGetProcessCreateTimeQuadPart(
283 _In_ PEPROCESS Process);
284 $endif (_NTDDK_)
285 $if (_NTIFS_)
286
287 _IRQL_requires_max_(PASSIVE_LEVEL)
288 NTKERNELAPI
289 VOID
290 NTAPI
291 PsDereferencePrimaryToken(
292 _In_ PACCESS_TOKEN PrimaryToken);
293
294 _IRQL_requires_max_(PASSIVE_LEVEL)
295 NTKERNELAPI
296 VOID
297 NTAPI
298 PsDereferenceImpersonationToken(
299 _In_ PACCESS_TOKEN ImpersonationToken);
300
301 _Must_inspect_result_
302 _IRQL_requires_max_(APC_LEVEL)
303 NTKERNELAPI
304 NTSTATUS
305 NTAPI
306 PsChargeProcessPoolQuota(
307 _In_ PEPROCESS Process,
308 _In_ POOL_TYPE PoolType,
309 _In_ ULONG_PTR Amount);
310
311 NTKERNELAPI
312 BOOLEAN
313 NTAPI
314 PsIsSystemThread(
315 _In_ PETHREAD Thread);
316 $endif (_NTIFS_)
317 $if (_NTDDK_ || _NTIFS_)
318 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) */
319 $endif (_NTDDK_ || _NTIFS_)
320
321 $if (_NTDDK_)
322 #if (NTDDI_VERSION >= NTDDI_WS03)
323 NTKERNELAPI
324 HANDLE
325 NTAPI
326 PsGetThreadProcessId(
327 IN PETHREAD Thread);
328 #endif /* (NTDDI_VERSION >= NTDDI_WS03) */
329
330 #if (NTDDI_VERSION >= NTDDI_VISTA)
331
332 NTKERNELAPI
333 BOOLEAN
334 NTAPI
335 PsSetCurrentThreadPrefetching(
336 IN BOOLEAN Prefetching);
337
338 NTKERNELAPI
339 BOOLEAN
340 NTAPI
341 PsIsCurrentThreadPrefetching(VOID);
342
343 #endif /* (NTDDI_VERSION >= NTDDI_VISTA) */
344
345 #if (NTDDI_VERSION >= NTDDI_VISTASP1)
346 NTKERNELAPI
347 NTSTATUS
348 NTAPI
349 PsSetCreateProcessNotifyRoutineEx(
350 IN PCREATE_PROCESS_NOTIFY_ROUTINE_EX NotifyRoutine,
351 IN BOOLEAN Remove);
352 #endif /* (NTDDI_VERSION >= NTDDI_VISTASP1) */
353 $endif (_NTDDK_)