[WIN32K]
[reactos.git] / reactos / win32ss / gdi / eng / engevent.c
index 51f7975..ab6e8ac 100644 (file)
 /* INCLUDES *******************************************************************/
 
 #include <win32k.h>
+
+#include <ntddvdeo.h>
+
 #define NDEBUG
 #include <debug.h>
 
 /* PUBLIC FUNCTIONS ***********************************************************/
 
+_Must_inspect_result_
+_Success_(return != FALSE)
 BOOL
 APIENTRY
-EngCreateEvent(OUT PEVENT* Event)
+EngCreateEvent(
+    _Outptr_ PEVENT *ppEvent)
 {
     BOOLEAN Result = TRUE;
     PENG_EVENT EngEvent;
@@ -38,7 +44,7 @@ EngCreateEvent(OUT PEVENT* Event)
                           FALSE);
 
         /* Pass pointer to our structure to the caller */
-        *Event = EngEvent;
+        *ppEvent = EngEvent;
         DPRINT("EngCreateEvent() created %p\n", EngEvent);
     }
     else
@@ -54,7 +60,8 @@ EngCreateEvent(OUT PEVENT* Event)
 
 BOOL
 APIENTRY
-EngDeleteEvent(IN PEVENT Event)
+EngDeleteEvent(
+    _In_ _Post_ptr_invalid_ PEVENT Event)
 {
     DPRINT("EngDeleteEvent(%p)\n", Event);
 
@@ -75,7 +82,8 @@ EngDeleteEvent(IN PEVENT Event)
 
 VOID
 APIENTRY
-EngClearEvent(IN PEVENT Event)
+EngClearEvent(
+    _In_ PEVENT Event)
 {
     /* Clear the event */
     KeClearEvent(Event->pKEvent);
@@ -83,7 +91,8 @@ EngClearEvent(IN PEVENT Event)
 
 LONG
 APIENTRY
-EngSetEvent(IN PEVENT Event)
+EngSetEvent(
+    _In_ PEVENT Event)
 {
     /* Set the event */
     return KeSetEvent(Event->pKEvent,
@@ -93,7 +102,8 @@ EngSetEvent(IN PEVENT Event)
 
 LONG
 APIENTRY
-EngReadStateEvent(IN PEVENT Event)
+EngReadStateEvent(
+    _In_ PEVENT Event)
 {
     /* Read the event state */
     return KeReadStateEvent(Event->pKEvent);
@@ -101,11 +111,12 @@ EngReadStateEvent(IN PEVENT Event)
 
 PEVENT
 APIENTRY
-EngMapEvent(IN HDEV hDev,
-            IN HANDLE hUserObject,
-            IN PVOID Reserved1,
-            IN PVOID Reserved2,
-            IN PVOID Reserved3)
+EngMapEvent(
+    _In_ HDEV hDev,
+    _In_ HANDLE hUserObject,
+    _Reserved_ PVOID Reserved1,
+    _Reserved_ PVOID Reserved2,
+    _Reserved_ PVOID Reserved3)
 {
     PENG_EVENT EngEvent;
     NTSTATUS Status;
@@ -147,7 +158,8 @@ EngMapEvent(IN HDEV hDev,
 
 BOOL
 APIENTRY
-EngUnmapEvent(IN PEVENT Event)
+EngUnmapEvent(
+    _In_ PEVENT Event)
 {
     /* Must be a usermapped event */
     if (!(Event->fFlags & ENG_EVENT_USERMAPPED)) return FALSE;
@@ -162,8 +174,9 @@ EngUnmapEvent(IN PEVENT Event)
 
 BOOL
 APIENTRY
-EngWaitForSingleObject(IN PEVENT Event,
-                       IN PLARGE_INTEGER TimeOut)
+EngWaitForSingleObject(
+    _In_ PEVENT Event,
+    _In_opt_ PLARGE_INTEGER TimeOut)
 {
     NTSTATUS Status;
     DPRINT("EngWaitForSingleObject(%p %I64d)\n", Event, TimeOut->QuadPart);