[ros-diffs] [akhaldi] 55264: [DDK] * Update dmusicks.h annotations.

Author: akhaldi
Date: Fri Jan 27 21:27:13 2012
New Revision: 55264

URL: http://svn.reactos.org/svn/reactos?rev=55264&view=rev
Log:
[DDK]
* Update dmusicks.h annotations.

Modified:
    trunk/reactos/include/ddk/dmusicks.h

Modified: trunk/reactos/include/ddk/dmusicks.h
URL:
http://svn.reactos.org/svn/reactos/trunk/reactos/include/ddk/dmusicks.h?rev…
==============================================================================
--- trunk/reactos/include/ddk/dmusicks.h [iso-8859-1] (original)
+++ trunk/reactos/include/ddk/dmusicks.h [iso-8859-1] Fri Jan 27 21:27:13 2012
@@ -46,15 +46,15 @@
   DEFINE_ABSTRACT_UNKNOWN()
 
   STDMETHOD_(NTSTATUS,GetTime)( THIS_
-    OUT REFERENCE_TIME *pTime
+    _Out_ REFERENCE_TIME *pTime
   ) PURE;
 };
 
 typedef IMasterClock *PMASTERCLOCK;
 
-#define IMP_IMasterClock           \
-  STDMETHODIMP_(NTSTATUS) GetTime( \
-    OUT REFERENCE_TIME *pTime      \
+#define IMP_IMasterClock             \
+  STDMETHODIMP_(NTSTATUS) GetTime(   \
+    _Out_ REFERENCE_TIME *pTime      \
   )
 
 /* ===============================================================
@@ -67,29 +67,29 @@
 struct IMXF;
 typedef struct IMXF *PMXF;
 
-#define DEFINE_ABSTRACT_IMXF()                 \
-  STDMETHOD_(NTSTATUS,SetState)(THIS_          \
-    IN KSSTATE State                           \
-  ) PURE;                                      \
-  STDMETHOD_(NTSTATUS,PutMessage)(THIS_        \
-    IN PDMUS_KERNEL_EVENT pDMKEvt              \
-  ) PURE;                                      \
-  STDMETHOD_(NTSTATUS,ConnectOutput)(THIS_     \
-    IN PMXF sinkMXF                            \
-  ) PURE;                                      \
-  STDMETHOD_(NTSTATUS,DisconnectOutput)(THIS_  \
-    IN PMXF sinkMXF                            \
-  ) PURE;
-
-#define IMP_IMXF                                   \
-  STDMETHODIMP_(NTSTATUS) SetState (               \
-    IN KSSTATE State);                             \
-  STDMETHODIMP_(NTSTATUS) PutMessage (THIS_        \
-    IN PDMUS_KERNEL_EVENT pDMKEvt);                \
-  STDMETHODIMP_(NTSTATUS) ConnectOutput (THIS_     \
-    IN PMXF sinkMXF);                              \
-  STDMETHODIMP_(NTSTATUS) DisconnectOutput (THIS_  \
-    IN PMXF sinkMXF)
+#define DEFINE_ABSTRACT_IMXF()                    \
+  STDMETHOD_(NTSTATUS,SetState)(THIS_             \
+    _In_ KSSTATE State                            \
+  ) PURE;                                         \
+  STDMETHOD_(NTSTATUS,PutMessage)(THIS_           \
+    _In_ PDMUS_KERNEL_EVENT pDMKEvt               \
+  ) PURE;                                         \
+  STDMETHOD_(NTSTATUS,ConnectOutput)(THIS_        \
+    _In_ PMXF sinkMXF                             \
+  ) PURE;                                         \
+  STDMETHOD_(NTSTATUS,DisconnectOutput)(THIS_     \
+    _In_ PMXF sinkMXF                             \
+  ) PURE;
+
+#define IMP_IMXF                                  \
+  STDMETHODIMP_(NTSTATUS) SetState (              \
+    _In_ KSSTATE State);                          \
+  STDMETHODIMP_(NTSTATUS) PutMessage (THIS_       \
+    _In_ PDMUS_KERNEL_EVENT pDMKEvt);             \
+  STDMETHODIMP_(NTSTATUS) ConnectOutput (THIS_    \
+    _In_ PMXF sinkMXF);                           \
+  STDMETHODIMP_(NTSTATUS) DisconnectOutput (THIS_ \
+    _In_ PMXF sinkMXF)
 
 DECLARE_INTERFACE_(IMXF,IUnknown) {
   DEFINE_ABSTRACT_UNKNOWN()
@@ -118,32 +118,33 @@
   DEFINE_ABSTRACT_IMXF()
 
   STDMETHOD_(NTSTATUS,GetMessage)(THIS_
-    OUT PDMUS_KERNEL_EVENT *ppDMKEvt
+    _Out_ PDMUS_KERNEL_EVENT *ppDMKEvt
   ) PURE;
 
   STDMETHOD_(USHORT,GetBufferSize)(THIS) PURE;
 
   STDMETHOD_(NTSTATUS,GetBuffer)(THIS_
-    OUT PBYTE *ppBuffer
+    _Outptr_result_bytebuffer_(_Inexpressible_(GetBufferSize bytes)) PBYTE *ppBuffer
   )PURE;
 
   STDMETHOD_(NTSTATUS,PutBuffer)(THIS_
-    IN PBYTE pBuffer
-  ) PURE;
-};
-
-#define IMP_IAllocatorMXF                     \
-  IMP_IMXF;                                   \
-  STDMETHODIMP_(NTSTATUS) GetMessage(         \
-    OUT PDMUS_KERNEL_EVENT *ppDMKEvt);        \
-                                              \
-  STDMETHODIMP_(USHORT) GetBufferSize(void);  \
-                                              \
-  STDMETHODIMP_(NTSTATUS) GetBuffer(          \
-    OUT PBYTE *ppBuffer);                     \
-                                              \
-  STDMETHODIMP_(NTSTATUS) PutBuffer(          \
-    IN PBYTE pBuffer)
+    _In_ PBYTE pBuffer
+  ) PURE;
+};
+
+#define IMP_IAllocatorMXF                                            \
+  IMP_IMXF;                                                          \
+  STDMETHODIMP_(NTSTATUS) GetMessage(                                \
+    _Out_ PDMUS_KERNEL_EVENT *ppDMKEvt);                             \
+                                                                     \
+  STDMETHODIMP_(USHORT) GetBufferSize(void);                         \
+                                                                     \
+  STDMETHODIMP_(NTSTATUS) GetBuffer(                                 \
+    _Outptr_result_bytebuffer_(_Inexpressible_(GetBufferSize bytes)) \
+      PBYTE *ppBuffer);                                              \
+                                                                     \
+  STDMETHODIMP_(NTSTATUS) PutBuffer(                                 \
+    _In_ PBYTE pBuffer)
 
 #undef INTERFACE
 #define INTERFACE IPortDMus
@@ -157,11 +158,11 @@
   DEFINE_ABSTRACT_PORT()
 
   STDMETHOD_(void,Notify)(THIS_
-    IN PSERVICEGROUP ServiceGroup OPTIONAL
+    _In_opt_ PSERVICEGROUP ServiceGroup
   ) PURE;
 
   STDMETHOD_(void,RegisterServiceGroup)(THIS_
-    IN PSERVICEGROUP ServiceGroup
+    _In_ PSERVICEGROUP ServiceGroup
   ) PURE;
 };
 typedef IPortDMus *PPORTDMUS;
@@ -169,10 +170,10 @@
 #define IMP_IPortDMus                         \
   IMP_IPort;                                  \
   STDMETHODIMP_(void) Notify(                 \
-    IN PSERVICEGROUP ServiceGroup OPTIONAL);  \
+    _In_opt_ PSERVICEGROUP ServiceGroup);  \
                                               \
   STDMETHODIMP_(void) RegisterServiceGroup(   \
-    IN PSERVICEGROUP ServiceGroup)
+    _In_ PSERVICEGROUP ServiceGroup)
 
 #undef INTERFACE
 #define INTERFACE IMiniportDMus
@@ -185,25 +186,25 @@
   DEFINE_ABSTRACT_MINIPORT()
 
   STDMETHOD_(NTSTATUS,Init)(THIS_
-    IN PUNKNOWN UnknownAdapter,
-    IN PRESOURCELIST ResourceList,
-    IN PPORTDMUS Port,
-    OUT PSERVICEGROUP *ServiceGroup
+    _In_opt_ PUNKNOWN UnknownAdapter,
+    _In_ PRESOURCELIST ResourceList,
+    _In_ PPORTDMUS Port,
+    _Out_ PSERVICEGROUP *ServiceGroup
   ) PURE;
 
   STDMETHOD_(void,Service)(THIS) PURE;
 
   STDMETHOD_(NTSTATUS,NewStream)(THIS_
-    OUT PMXF *MXF,
-    IN PUNKNOWN OuterUnknown OPTIONAL,
-    IN POOL_TYPE PoolType,
-    IN ULONG PinID,
-    IN DMUS_STREAM_TYPE StreamType,
-    IN PKSDATAFORMAT DataFormat,
-    OUT PSERVICEGROUP *ServiceGroup,
-    IN PAllocatorMXF AllocatorMXF,
-    IN PMASTERCLOCK MasterClock,
-    OUT PULONGLONG SchedulePreFetch
+    _Out_ PMXF *MXF,
+    _In_opt_ PUNKNOWN OuterUnknown,
+    _In_ POOL_TYPE PoolType,
+    _In_ ULONG PinID,
+    _In_ DMUS_STREAM_TYPE StreamType,
+    _In_ PKSDATAFORMAT DataFormat,
+    _Out_ PSERVICEGROUP *ServiceGroup,
+    _In_ PAllocatorMXF AllocatorMXF,
+    _In_ PMASTERCLOCK MasterClock,
+    _Out_ PULONGLONG SchedulePreFetch
   ) PURE;
 };
 
@@ -213,24 +214,24 @@
 #define IMP_IMiniportDMus               \
   IMP_IMiniport;                        \
   STDMETHODIMP_(NTSTATUS) Init(         \
-    IN PUNKNOWN UnknownAdapter,         \
-    IN PRESOURCELIST ResourceList,      \
-    IN PPORTDMUS Port,                  \
-    OUT PSERVICEGROUP *ServiceGroup);   \
+    _In_opt_ PUNKNOWN UnknownAdapter,   \
+    _In_ PRESOURCELIST ResourceList,    \
+    _In_ PPORTDMUS Port,                \
+    _Out_ PSERVICEGROUP *ServiceGroup); \
                                         \
   STDMETHODIMP_(void) Service(THIS);    \
                                         \
   STDMETHODIMP_(NTSTATUS) NewStream(    \
-    OUT PMXF *MXF,                      \
-    IN PUNKNOWN OuterUnknown,           \
-    IN POOL_TYPE PoolType,              \
-    IN ULONG PinID,                     \
-    IN DMUS_STREAM_TYPE StreamType,     \
-    IN PKSDATAFORMAT DataFormat,        \
-    OUT PSERVICEGROUP *ServiceGroup,    \
-    IN PAllocatorMXF AllocatorMXF,      \
-    IN PMASTERCLOCK MasterClock,        \
-    OUT PULONGLONG SchedulePreFetch)
+    _Out_ PMXF *MXF,                    \
+    _In_opt_ PUNKNOWN OuterUnknown,     \
+    _In_ POOL_TYPE PoolType,            \
+    _In_ ULONG PinID,                   \
+    _In_ DMUS_STREAM_TYPE StreamType,   \
+    _In_ PKSDATAFORMAT DataFormat,      \
+    _Out_ PSERVICEGROUP *ServiceGroup,  \
+    _In_ PAllocatorMXF AllocatorMXF,    \
+    _In_ PMASTERCLOCK MasterClock,      \
+    _Out_ PULONGLONG SchedulePreFetch)
 
 
 #define STATIC_KSAUDFNAME_DMUSIC_MPU_OUT\