src/libcaptive/nt/ntevent.c

   1 /* $Id$
   2  * reactos support for event handling for reactos of libcaptive
   3  * Copyright (C) 2002 Jan Kratochvil <project-captive@jankratochvil.net>
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; exactly version 2 of June 1991 is required
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program; if not, write to the Free Software
  16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  17  */
  18
  19
  20 #include "config.h"
  21
  22 #include "reactos/ntos/zw.h"    /* self */
  23 #include <glib/gmessages.h>
  24
  25
  26 /**
  27  * ZwCreateEvent:
  28  * @EventHandle: Returns new created #HANDLE.
  29  * %NULL value is forbidden.
  30  * @DesiredAccess: Required access privileges to the created event handle.
  31  * @ObjectAttributes: Event object attributes by InitializeObjectAttributes().
  32  * %NULL value is forbidden.
  33  * @ManualReset: Use %NotificationEvent instead of %SynchronizationEvent.
  34  * @InitialState: initial state of the created @EventHandle.
  35  *
  36  * Direct pass to NtCreateEvent(). reactos aliases this call to NtCreateEvent()
  37  * in its "reactos/iface/native/sysfuncs.lst" file.
  38  *
  39  * Returns: Return status code from NtCreateEvent().
  40  */
  41 NTSTATUS ZwCreateEvent(OUT PHANDLE EventHandle,
  42                 IN ACCESS_MASK DesiredAccess,IN POBJECT_ATTRIBUTES ObjectAttributes,IN BOOLEAN ManualReset,IN BOOLEAN InitialState)
  43 {
  44         g_return_val_if_fail(EventHandle!=NULL,STATUS_INVALID_HANDLE);
  45         g_return_val_if_fail(ObjectAttributes!=NULL,STATUS_INVALID_HANDLE);
  46
  47         return NtCreateEvent(EventHandle,DesiredAccess,ObjectAttributes,ManualReset,InitialState);
  48 }