Author: akhaldi
Date: Fri Jan 27 17:34:49 2012
New Revision: 55252
URL: http://svn.reactos.org/svn/reactos?rev=55252&view=rev
Log:
[DDK]
* Update csq.h annotations.
Modified:
trunk/reactos/include/ddk/csq.h
Modified: trunk/reactos/include/ddk/csq.h
URL:
http://svn.reactos.org/svn/reactos/trunk/reactos/include/ddk/csq.h?rev=55252&r1=55251&r2=55252&view=diff
==============================================================================
--- trunk/reactos/include/ddk/csq.h [iso-8859-1] (original)
+++ trunk/reactos/include/ddk/csq.h [iso-8859-1] Fri Jan 27 17:34:49 2012
@@ -112,8 +112,8 @@
*/
typedef VOID
(NTAPI IO_CSQ_INSERT_IRP)(
- IN struct _IO_CSQ *Csq,
- IN PIRP Irp);
+ _In_ struct _IO_CSQ *Csq,
+ _In_ PIRP Irp);
typedef IO_CSQ_INSERT_IRP *PIO_CSQ_INSERT_IRP;
/*
@@ -130,8 +130,8 @@
*/
typedef VOID
(NTAPI IO_CSQ_REMOVE_IRP)(
- IN struct _IO_CSQ *Csq,
- IN PIRP Irp);
+ _In_ struct _IO_CSQ *Csq,
+ _In_ PIRP Irp);
typedef IO_CSQ_REMOVE_IRP *PIO_CSQ_REMOVE_IRP;
/*
@@ -155,9 +155,9 @@
*/
typedef PIRP
(NTAPI IO_CSQ_PEEK_NEXT_IRP)(
- IN struct _IO_CSQ *Csq,
- IN PIRP Irp,
- IN PVOID PeekContext);
+ _In_ struct _IO_CSQ *Csq,
+ _In_opt_ PIRP Irp,
+ _In_opt_ PVOID PeekContext);
typedef IO_CSQ_PEEK_NEXT_IRP *PIO_CSQ_PEEK_NEXT_IRP;
/*
@@ -175,8 +175,8 @@
*/
typedef VOID
(NTAPI IO_CSQ_ACQUIRE_LOCK)(
- IN struct _IO_CSQ *Csq,
- OUT PKIRQL Irql);
+ _In_ struct _IO_CSQ *Csq,
+ _Out_ PKIRQL Irql);
typedef IO_CSQ_ACQUIRE_LOCK *PIO_CSQ_ACQUIRE_LOCK;
/*
@@ -191,8 +191,8 @@
*/
typedef VOID
(NTAPI IO_CSQ_RELEASE_LOCK)(
- IN struct _IO_CSQ *Csq,
- IN KIRQL Irql);
+ _In_ struct _IO_CSQ *Csq,
+ _In_ KIRQL Irql);
typedef IO_CSQ_RELEASE_LOCK *PIO_CSQ_RELEASE_LOCK;
/*
@@ -212,8 +212,8 @@
*/
typedef VOID
(NTAPI IO_CSQ_COMPLETE_CANCELED_IRP)(
- IN struct _IO_CSQ *Csq,
- IN PIRP Irp);
+ _In_ struct _IO_CSQ *Csq,
+ _In_ PIRP Irp);
typedef IO_CSQ_COMPLETE_CANCELED_IRP *PIO_CSQ_COMPLETE_CANCELED_IRP;
/*
@@ -253,9 +253,9 @@
*/
typedef NTSTATUS
(NTAPI IO_CSQ_INSERT_IRP_EX)(
- IN struct _IO_CSQ *Csq,
- IN PIRP Irp,
- IN PVOID InsertContext);
+ _In_ struct _IO_CSQ *Csq,
+ _In_ PIRP Irp,
+ _In_ PVOID InsertContext);
typedef IO_CSQ_INSERT_IRP_EX *PIO_CSQ_INSERT_IRP_EX;
#endif /* IO_TYPE_CSQ_EX */
@@ -275,13 +275,13 @@
* there are no IRQL restrictions.
*/
NTKERNELAPI
-NTSTATUS NTAPI IoCsqInitialize(PIO_CSQ Csq,
- PIO_CSQ_INSERT_IRP CsqInsertIrp,
- PIO_CSQ_REMOVE_IRP CsqRemoveIrp,
- PIO_CSQ_PEEK_NEXT_IRP CsqPeekNextIrp,
- PIO_CSQ_ACQUIRE_LOCK CsqAcquireLock,
- PIO_CSQ_RELEASE_LOCK CsqReleaseLock,
- PIO_CSQ_COMPLETE_CANCELED_IRP
CsqCompleteCanceledIrp);
+NTSTATUS NTAPI IoCsqInitialize(_In_ PIO_CSQ Csq,
+ _In_ PIO_CSQ_INSERT_IRP CsqInsertIrp,
+ _In_ PIO_CSQ_REMOVE_IRP CsqRemoveIrp,
+ _In_ PIO_CSQ_PEEK_NEXT_IRP CsqPeekNextIrp,
+ _In_ PIO_CSQ_ACQUIRE_LOCK CsqAcquireLock,
+ _In_ PIO_CSQ_RELEASE_LOCK CsqReleaseLock,
+ _In_ PIO_CSQ_COMPLETE_CANCELED_IRP
CsqCompleteCanceledIrp);
/*
* Same as above, except you provide a CsqInsertIrpEx routine instead of
@@ -289,45 +289,45 @@
* information for use with the queue.
*/
NTKERNELAPI
-NTSTATUS NTAPI IoCsqInitializeEx(PIO_CSQ Csq,
- PIO_CSQ_INSERT_IRP_EX CsqInsertIrpEx,
- PIO_CSQ_REMOVE_IRP CsqRemoveIrp,
- PIO_CSQ_PEEK_NEXT_IRP CsqPeekNextIrp,
- PIO_CSQ_ACQUIRE_LOCK CsqAcquireLock,
- PIO_CSQ_RELEASE_LOCK CsqReleaseLock,
- PIO_CSQ_COMPLETE_CANCELED_IRP
CsqCompleteCanceledIrp);
+NTSTATUS NTAPI IoCsqInitializeEx(_In_ PIO_CSQ Csq,
+ _In_ PIO_CSQ_INSERT_IRP_EX CsqInsertIrpEx,
+ _In_ PIO_CSQ_REMOVE_IRP CsqRemoveIrp,
+ _In_ PIO_CSQ_PEEK_NEXT_IRP CsqPeekNextIrp,
+ _In_ PIO_CSQ_ACQUIRE_LOCK CsqAcquireLock,
+ _In_ PIO_CSQ_RELEASE_LOCK CsqReleaseLock,
+ _In_ PIO_CSQ_COMPLETE_CANCELED_IRP
CsqCompleteCanceledIrp);
/*
* Insert an IRP into the queue
*/
NTKERNELAPI
-VOID NTAPI IoCsqInsertIrp(PIO_CSQ Csq,
- PIRP Irp,
- PIO_CSQ_IRP_CONTEXT Context);
+VOID NTAPI IoCsqInsertIrp(_In_ PIO_CSQ Csq,
+ _In_ PIRP Irp,
+ _In_opt_ PIO_CSQ_IRP_CONTEXT Context);
/*
* Insert an IRP into the queue, with special context maintained that
* makes it easy to find IRPs in the queue
*/
NTKERNELAPI
-NTSTATUS NTAPI IoCsqInsertIrpEx(PIO_CSQ Csq,
- PIRP Irp,
- PIO_CSQ_IRP_CONTEXT Context,
- PVOID InsertContext);
+NTSTATUS NTAPI IoCsqInsertIrpEx(_In_ PIO_CSQ Csq,
+ _In_ PIRP Irp,
+ _In_opt_ PIO_CSQ_IRP_CONTEXT Context,
+ _In_opt_ PVOID InsertContext);
/*
* Remove a particular IRP from the queue
*/
NTKERNELAPI
-PIRP NTAPI IoCsqRemoveIrp(PIO_CSQ Csq,
- PIO_CSQ_IRP_CONTEXT Context);
+PIRP NTAPI IoCsqRemoveIrp(_In_ PIO_CSQ Csq,
+ _In_ PIO_CSQ_IRP_CONTEXT Context);
/*
* Remove the next IRP from the queue
*/
NTKERNELAPI
-PIRP NTAPI IoCsqRemoveNextIrp(PIO_CSQ Csq,
- PVOID PeekContext);
+PIRP NTAPI IoCsqRemoveNextIrp(_In_ PIO_CSQ Csq,
+ _In_opt_ PVOID PeekContext);
#ifdef __cplusplus
}
