[ros-diffs] [akhaldi] 59798: [PSDK] * Annotate mstcpip.h.

Author: akhaldi
Date: Fri Aug 23 15:26:52 2013
New Revision: 59798

URL: http://svn.reactos.org/svn/reactos?rev=59798&view=rev
Log:
[PSDK]
* Annotate mstcpip.h.

Modified:
    trunk/reactos/include/psdk/mstcpip.h

Modified: trunk/reactos/include/psdk/mstcpip.h
URL:
http://svn.reactos.org/svn/reactos/trunk/reactos/include/psdk/mstcpip.h?rev…
==============================================================================
--- trunk/reactos/include/psdk/mstcpip.h	[iso-8859-1] (original)
+++ trunk/reactos/include/psdk/mstcpip.h	[iso-8859-1] Fri Aug 23 15:26:52 2013
@@ -236,8 +236,8 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_ADDR_EQUAL(
-  IN CONST IN_ADDR *a,
-  IN CONST IN_ADDR *b)
+  _In_ CONST IN_ADDR *a,
+  _In_ CONST IN_ADDR *b)
 {
   return (BOOLEAN)(a->s_addr == b->s_addr);
 }
@@ -245,8 +245,8 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_UNALIGNED_ADDR_EQUAL(
-  IN CONST IN_ADDR UNALIGNED *a,
-  IN CONST IN_ADDR UNALIGNED *b)
+  _In_ CONST IN_ADDR UNALIGNED *a,
+  _In_ CONST IN_ADDR UNALIGNED *b)
 {
   return (BOOLEAN)(a->s_addr == b->s_addr);
 }
@@ -254,7 +254,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_UNSPECIFIED(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   return (BOOLEAN)(a->s_addr == IN4ADDR_ANY);
 }
@@ -262,7 +262,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_UNALIGNED_ADDR_UNSPECIFIED(
-  IN CONST IN_ADDR UNALIGNED *a)
+  _In_ CONST IN_ADDR UNALIGNED *a)
 {
   return (BOOLEAN)(a->s_addr == IN4ADDR_ANY);
 }
@@ -270,7 +270,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_LOOPBACK(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   return (BOOLEAN)(*((PUCHAR) a) == 0x7f);
 }
@@ -278,7 +278,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_UNALIGNED_ADDR_LOOPBACK(
-  IN CONST IN_ADDR UNALIGNED *a)
+  _In_ CONST IN_ADDR UNALIGNED *a)
 {
   return (BOOLEAN)(*((PUCHAR) a) == 0x7f);
 }
@@ -286,7 +286,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_BROADCAST(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   return (BOOLEAN)(a->s_addr == IN4ADDR_BROADCAST);
 }
@@ -294,7 +294,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_UNALIGNED_ADDR_BROADCAST(
-  IN CONST IN_ADDR UNALIGNED *a)
+  _In_ CONST IN_ADDR UNALIGNED *a)
 {
   return (BOOLEAN)(a->s_addr == IN4ADDR_BROADCAST);
 }
@@ -302,7 +302,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_MULTICAST(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   return (BOOLEAN)IN4_MULTICAST(a->s_addr);
 }
@@ -310,7 +310,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_UNALIGNED_ADDR_MULTICAST(
-  IN CONST IN_ADDR UNALIGNED *a)
+  _In_ CONST IN_ADDR UNALIGNED *a)
 {
   return (BOOLEAN)IN4_MULTICAST(a->s_addr);
 }
@@ -318,7 +318,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_LINKLOCAL(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   return (BOOLEAN)((a->s_addr & 0xffff) == 0xfea9);
 }
@@ -326,7 +326,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_UNALIGNED_ADDR_LINKLOCAL(
-  IN CONST IN_ADDR UNALIGNED *a)
+  _In_ CONST IN_ADDR UNALIGNED *a)
 {
   return (BOOLEAN)((a->s_addr & 0xffff) == 0xfea9); // 169.254/16
 }
@@ -334,7 +334,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_SITELOCAL(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   UNREFERENCED_PARAMETER(a);
   return FALSE;
@@ -344,7 +344,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_RFC1918(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   return (BOOLEAN)(((a->s_addr & 0x00ff) == 0x0a) ||
                    ((a->s_addr & 0xf0ff) == 0x10ac) ||
@@ -354,7 +354,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_UNALIGNED_ADDR_RFC1918(
-  IN CONST IN_ADDR UNALIGNED *a)
+  _In_ CONST IN_ADDR UNALIGNED *a)
 {
   IN_ADDR Ipv4Address = *a;
   return IN4_IS_ADDR_RFC1918(&Ipv4Address);
@@ -363,7 +363,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_MC_LINKLOCAL(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   return (BOOLEAN)((a->s_addr & 0xffffff) == 0xe0);
 }
@@ -371,7 +371,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_MC_ADMINLOCAL(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   return (BOOLEAN)((a->s_addr & 0xffff) == 0xffef);
 }
@@ -379,7 +379,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_MC_SITELOCAL(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   return (BOOLEAN)((a->s_addr & 0xff) == 0xef) &&
                   !IN4_IS_ADDR_MC_ADMINLOCAL(a);
@@ -388,9 +388,9 @@
 MSTCPIP_INLINE
 VOID
 IN4ADDR_SETSOCKADDR(
-  OUT PSOCKADDR_IN a,
-  IN CONST IN_ADDR *addr,
-  IN USHORT port)
+  _Out_ PSOCKADDR_IN a,
+  _In_ CONST IN_ADDR *addr,
+  _In_ USHORT port)
 {
   a->sin_family = AF_INET;
   a->sin_port = port;
@@ -401,7 +401,7 @@
 MSTCPIP_INLINE
 VOID
 IN4ADDR_SETANY(
-  OUT PSOCKADDR_IN a)
+  _Out_ PSOCKADDR_IN a)
 {
   a->sin_family = AF_INET;
   a->sin_port = 0;
@@ -412,7 +412,7 @@
 MSTCPIP_INLINE
 VOID
 IN4ADDR_SETLOOPBACK(
-  OUT PSOCKADDR_IN a)
+  _Out_ PSOCKADDR_IN a)
 {
   a->sin_family = AF_INET;
   a->sin_port = 0;
@@ -423,7 +423,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4ADDR_ISANY(
-  IN CONST SOCKADDR_IN *a)
+  _In_ CONST SOCKADDR_IN *a)
 {
   ASSERT(a->sin_family == AF_INET);
   return IN4_IS_ADDR_UNSPECIFIED(&a->sin_addr);
@@ -432,7 +432,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4ADDR_ISLOOPBACK(
-  IN CONST SOCKADDR_IN *a)
+  _In_ CONST SOCKADDR_IN *a)
 {
   ASSERT(a->sin_family == AF_INET);
   return IN4_IS_ADDR_LOOPBACK(&a->sin_addr);
@@ -441,7 +441,7 @@
 MSTCPIP_INLINE
 SCOPE_ID
 IN4ADDR_SCOPE_ID(
-  IN CONST SOCKADDR_IN *a)
+  _In_ CONST SOCKADDR_IN *a)
 {
   SCOPE_ID UnspecifiedScopeId = {{{0}}};
   UNREFERENCED_PARAMETER(a);
@@ -451,8 +451,8 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4ADDR_ISEQUAL(
-  IN CONST SOCKADDR_IN *a,
-  IN CONST SOCKADDR_IN *b)
+  _In_ CONST SOCKADDR_IN *a,
+  _In_ CONST SOCKADDR_IN *b)
 {
   ASSERT(a->sin_family == AF_INET);
   return (BOOLEAN)(IN4ADDR_SCOPE_ID(a).Value == IN4ADDR_SCOPE_ID(b).Value &&
@@ -462,7 +462,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4ADDR_ISUNSPECIFIED(
-  IN CONST SOCKADDR_IN *a)
+  _In_ CONST SOCKADDR_IN *a)
 {
   ASSERT(a->sin_family == AF_INET);
   return (BOOLEAN)(IN4ADDR_SCOPE_ID(a).Value == 0 &&
@@ -475,7 +475,7 @@
 MSTCPIP_INLINE
 SCOPE_LEVEL
 Ipv4UnicastAddressScope(
-  IN CONST UCHAR *Address)
+  _In_ CONST UCHAR *Address)
 {
   IN_ADDR Ipv4Address;
 
@@ -493,7 +493,7 @@
 MSTCPIP_INLINE
 SCOPE_LEVEL
 Ipv4MulticastAddressScope(
-  IN CONST UCHAR *Address)
+  _In_ CONST UCHAR *Address)
 {
   IN_ADDR Ipv4Address;
 
@@ -515,9 +515,9 @@
 MSTCPIP_INLINE
 SCOPE_LEVEL
 Ipv4AddressScope(
-  IN CONST UCHAR *Address)
-{
-  IN CONST IN_ADDR Ipv4Address = *(CONST IN_ADDR UNALIGNED *)Address;
+  _In_ CONST UCHAR *Address)
+{
+  CONST IN_ADDR Ipv4Address = *(CONST IN_ADDR UNALIGNED *)Address;
 
   if (IN4_IS_ADDR_BROADCAST(&Ipv4Address)) {
     return ScopeLevelLink;
@@ -531,7 +531,7 @@
 MSTCPIP_INLINE
 NL_ADDRESS_TYPE
 Ipv4AddressType(
-  IN CONST UCHAR *Address)
+  _In_ CONST UCHAR *Address)
 {
   IN_ADDR Ipv4Address = *(CONST IN_ADDR UNALIGNED *) Address;
 
@@ -554,8 +554,8 @@
 MSTCPIP_INLINE
 VOID
 IN4_UNCANONICALIZE_SCOPE_ID(
-  IN CONST IN_ADDR *Address,
-  IN OUT SCOPE_ID *ScopeId)
+  _In_ CONST IN_ADDR *Address,
+  _Inout_ SCOPE_ID *ScopeId)
 {
   SCOPE_LEVEL ScopeLevel = Ipv4AddressScope((CONST UCHAR *)Address);
 
@@ -570,7 +570,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_ADDR_6TO4ELIGIBLE(
-  IN CONST IN_ADDR *a)
+  _In_ CONST IN_ADDR *a)
 {
   return (BOOLEAN)((Ipv4AddressType((CONST UCHAR *) a) == NlatUnicast) &&
                    !(IN4_IS_ADDR_LOOPBACK(a) ||
@@ -582,7 +582,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN4_IS_UNALIGNED_ADDR_6TO4ELIGIBLE(
-  IN CONST IN_ADDR UNALIGNED *a)
+  _In_ CONST IN_ADDR UNALIGNED *a)
 {
   IN_ADDR Ipv4Address = *a;
   return IN4_IS_ADDR_6TO4ELIGIBLE(&Ipv4Address);
@@ -597,9 +597,9 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6_PREFIX_EQUAL(
-  IN CONST IN6_ADDR *a,
-  IN CONST IN6_ADDR *b,
-  IN UINT8 len)
+  _In_ CONST IN6_ADDR *a,
+  _In_ CONST IN6_ADDR *b,
+  _In_ UINT8 len)
 {
   UINT8 Bytes = len / 8;
   UINT8 Bits = len % 8;
@@ -613,7 +613,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6_IS_ADDR_ALLNODESONNODE(
-  IN CONST IN6_ADDR *a)
+  _In_ CONST IN6_ADDR *a)
 {
   return IN6_ADDR_EQUAL(a, &in6addr_allnodesonnode);
 }
@@ -621,7 +621,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6_IS_ADDR_ALLNODESONLINK(
-  IN CONST IN6_ADDR *a)
+  _In_ CONST IN6_ADDR *a)
 {
   return IN6_ADDR_EQUAL(a, &in6addr_allnodesonlink);
 }
@@ -629,7 +629,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6_IS_ADDR_ALLROUTERSONLINK(
-  IN CONST IN6_ADDR *a)
+  _In_ CONST IN6_ADDR *a)
 {
   return IN6_ADDR_EQUAL(a, &in6addr_allroutersonlink);
 }
@@ -637,7 +637,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6_IS_ADDR_SOLICITEDNODE(
-  IN CONST IN6_ADDR *a)
+  _In_ CONST IN6_ADDR *a)
 {
   return IN6_PREFIX_EQUAL(a, &in6addr_solicitednodemulticastprefix,
                           IN6ADDR_SOLICITEDNODEMULTICASTPREFIX_LENGTH);
@@ -646,7 +646,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6_IS_ADDR_ISATAP(
-  IN CONST IN6_ADDR *a)
+  _In_ CONST IN6_ADDR *a)
 {
   return (BOOLEAN)(((a->s6_words[4] & 0xfffd) == 0x0000) &&
                    (a->s6_words[5] == 0xfe5e));
@@ -655,7 +655,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6_IS_ADDR_6TO4(
-  IN CONST IN6_ADDR *a)
+  _In_ CONST IN6_ADDR *a)
 {
   C_ASSERT(IN6ADDR_6TO4PREFIX_LENGTH == RTL_BITS_OF(USHORT));
   return (BOOLEAN)(a->s6_words[0] == in6addr_6to4prefix.s6_words[0]);
@@ -664,7 +664,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6_IS_ADDR_TEREDO(
-  IN CONST IN6_ADDR *a)
+  _In_ CONST IN6_ADDR *a)
 {
   C_ASSERT(IN6ADDR_TEREDOPREFIX_LENGTH == 2 * RTL_BITS_OF(USHORT));
   return (BOOLEAN)
@@ -677,7 +677,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6ADDR_ISV4MAPPED(
-  IN CONST SOCKADDR_IN6 *a)
+  _In_ CONST SOCKADDR_IN6 *a)
 {
   ASSERT(a->sin6_family == AF_INET6);
   return IN6_IS_ADDR_V4MAPPED(&a->sin6_addr);
@@ -686,7 +686,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6ADDR_ISISATAP(
-  IN CONST SOCKADDR_IN6 *a)
+  _In_ CONST SOCKADDR_IN6 *a)
 {
   ASSERT(a->sin6_family == AF_INET6);
   return IN6_IS_ADDR_ISATAP(&a->sin6_addr);
@@ -695,7 +695,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6ADDR_IS6TO4(
-  IN CONST SOCKADDR_IN6 *a)
+  _In_ CONST SOCKADDR_IN6 *a)
 {
   ASSERT(a->sin6_family == AF_INET6);
   return IN6_IS_ADDR_6TO4(&a->sin6_addr);
@@ -704,7 +704,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 IN6ADDR_ISTEREDO(
-  IN CONST SOCKADDR_IN6 *a)
+  _In_ CONST SOCKADDR_IN6 *a)
 {
   ASSERT(a->sin6_family == AF_INET6);
   return IN6_IS_ADDR_TEREDO(&a->sin6_addr);
@@ -713,7 +713,7 @@
 MSTCPIP_INLINE
 CONST UCHAR*
 IN6_GET_ADDR_V4MAPPED(
-  IN CONST IN6_ADDR *Ipv6Address)
+  _In_ CONST IN6_ADDR *Ipv6Address)
 {
   return (CONST UCHAR *) (Ipv6Address->s6_words + 6);
 }
@@ -721,7 +721,7 @@
 MSTCPIP_INLINE
 CONST UCHAR*
 IN6_GET_ADDR_V4COMPAT(
-  IN CONST IN6_ADDR *Ipv6Address)
+  _In_ CONST IN6_ADDR *Ipv6Address)
 {
   return (CONST UCHAR *) (Ipv6Address->s6_words + 6);
 }
@@ -729,7 +729,7 @@
 MSTCPIP_INLINE
 CONST UCHAR*
 IN6_EXTRACT_V4ADDR_FROM_ISATAP(
-  IN CONST IN6_ADDR *Ipv6Address)
+  _In_ CONST IN6_ADDR *Ipv6Address)
 {
   return (CONST UCHAR *) (Ipv6Address->s6_words + 6);
 }
@@ -737,7 +737,7 @@
 MSTCPIP_INLINE
 CONST UCHAR*
 IN6_EXTRACT_V4ADDR_FROM_6TO4(
-  IN CONST IN6_ADDR *Ipv6Address)
+  _In_ CONST IN6_ADDR *Ipv6Address)
 {
   return (CONST UCHAR *) (Ipv6Address->s6_words + 1);
 }
@@ -745,8 +745,8 @@
 MSTCPIP_INLINE
 VOID
 IN6_SET_ADDR_V4MAPPED(
-  OUT PIN6_ADDR a6,
-  IN CONST IN_ADDR* a4)
+  _Out_ PIN6_ADDR a6,
+  _In_ CONST IN_ADDR* a4)
 {
   *a6 = in6addr_v4mappedprefix;
   a6->s6_bytes[12] = ((CONST UCHAR *) a4)[0];
@@ -758,8 +758,8 @@
 MSTCPIP_INLINE
 VOID
 IN6_SET_ADDR_V4COMPAT(
-  OUT PIN6_ADDR a6,
-  IN CONST IN_ADDR* a4)
+  _Out_ PIN6_ADDR a6,
+  _In_ CONST IN_ADDR* a4)
 {
   *a6 = in6addr_any;
   a6->s6_bytes[12] = ((CONST UCHAR *) a4)[0];
@@ -771,8 +771,8 @@
 MSTCPIP_INLINE
 VOID
 IN6_SET_ADDR_SOLICITEDNODE(
-  OUT PIN6_ADDR Multicast,
-  IN CONST IN6_ADDR *Unicast)
+  _Out_ PIN6_ADDR Multicast,
+  _In_ CONST IN6_ADDR *Unicast)
 {
   *Multicast = in6addr_solicitednodemulticastprefix;
   Multicast->s6_bytes[13] = Unicast->s6_bytes[13];
@@ -783,8 +783,8 @@
 MSTCPIP_INLINE
 VOID
 IN6_SET_ISATAP_IDENTIFIER(
-  IN OUT IN6_ADDR *Ipv6Address,
-  IN CONST IN_ADDR *Ipv4Address)
+  _Inout_ IN6_ADDR *Ipv6Address,
+  _In_ CONST IN_ADDR *Ipv4Address)
 {
   if (IN4_IS_ADDR_6TO4ELIGIBLE(Ipv4Address)) {
     Ipv6Address->s6_words[4] = 0x0002;
@@ -798,8 +798,8 @@
 MSTCPIP_INLINE
 VOID
 IN6_SET_6TO4_PREFIX(
-  IN OUT IN6_ADDR *Ipv6Address,
-  IN CONST IN_ADDR *Ipv4Address)
+  _Inout_ IN6_ADDR *Ipv6Address,
+  _In_ CONST IN_ADDR *Ipv4Address)
 {
   Ipv6Address->s6_words[0] = 0x0220;
   *((UNALIGNED IN_ADDR *) (Ipv6Address->s6_words + 1)) = *Ipv4Address;
@@ -809,7 +809,7 @@
 MSTCPIP_INLINE
 SCOPE_LEVEL
 Ipv6UnicastAddressScope(
-  IN CONST UCHAR *Address)
+  _In_ CONST UCHAR *Address)
 {
   IN6_ADDR Ipv6Address;
 
@@ -830,7 +830,7 @@
 MSTCPIP_INLINE
 SCOPE_LEVEL
 IN6_MULTICAST_SCOPE(
-  IN CONST UCHAR *Address)
+  _In_ CONST UCHAR *Address)
 {
   PIN6_ADDR Ipv6Address = (PIN6_ADDR) Address;
   return (SCOPE_LEVEL)(Ipv6Address->s6_bytes[1] & 0xf);
@@ -839,7 +839,7 @@
 MSTCPIP_INLINE
 SCOPE_LEVEL
 Ipv6AddressScope(
-  IN CONST UCHAR *Address)
+  _In_ CONST UCHAR *Address)
 {
   if (IN6_IS_ADDR_MULTICAST((CONST IN6_ADDR *) Address)) {
     return IN6_MULTICAST_SCOPE(Address);
@@ -851,7 +851,7 @@
 MSTCPIP_INLINE
 NL_ADDRESS_TYPE
 Ipv6AddressType(
-  IN CONST UCHAR *Address)
+  _In_ CONST UCHAR *Address)
 {
   CONST IN6_ADDR *Ipv6Address = (CONST IN6_ADDR *) Address;
   CONST UCHAR *Ipv4Address;
@@ -879,8 +879,8 @@
 MSTCPIP_INLINE
 VOID
 IN6_UNCANONICALIZE_SCOPE_ID(
-  IN CONST IN6_ADDR *Address,
-  IN OUT SCOPE_ID *ScopeId)
+  _In_ CONST IN6_ADDR *Address,
+  _Inout_ SCOPE_ID *ScopeId)
 {
   SCOPE_LEVEL ScopeLevel = Ipv6AddressScope((CONST UCHAR *)Address);
 
@@ -897,10 +897,10 @@
 MSTCPIP_INLINE
 VOID
 IN6ADDR_SETSOCKADDR(
-  OUT PSOCKADDR_IN6 a,
-  IN CONST IN6_ADDR *addr,
-  IN SCOPE_ID scope,
-  IN USHORT port)
+  _Out_ PSOCKADDR_IN6 a,
+  _In_ CONST IN6_ADDR *addr,
+  _In_ SCOPE_ID scope,
+  _In_ USHORT port)
 {
   a->sin6_family = AF_INET6;
   a->sin6_port = port;
@@ -913,10 +913,10 @@
 MSTCPIP_INLINE
 VOID
 IN6ADDR_SETV4MAPPED(
-  OUT PSOCKADDR_IN6 a6,
-  IN CONST IN_ADDR* a4,
-  IN SCOPE_ID scope,
-  IN USHORT port)
+  _Out_ PSOCKADDR_IN6 a6,
+  _In_ CONST IN_ADDR* a4,
+  _In_ SCOPE_ID scope,
+  _In_ USHORT port)
 {
   a6->sin6_family = AF_INET6;
   a6->sin6_port = port;
@@ -931,9 +931,9 @@
 MSTCPIP_INLINE
 BOOLEAN
 INET_ADDR_EQUAL(
-  IN ADDRESS_FAMILY af,
-  IN CONST VOID* a,
-  IN CONST VOID* b)
+  _In_ ADDRESS_FAMILY af,
+  _In_ CONST VOID* a,
+  _In_ CONST VOID* b)
 {
   if (af == AF_INET6) {
     return IN6_ADDR_EQUAL((CONST IN6_ADDR*)a, (CONST IN6_ADDR*)b);
@@ -946,9 +946,9 @@
 MSTCPIP_INLINE
 BOOLEAN
 INET_UNALIGNED_ADDR_EQUAL(
-  IN ADDRESS_FAMILY af,
-  IN CONST VOID* a,
-  IN CONST VOID* b)
+  _In_ ADDRESS_FAMILY af,
+  _In_ CONST VOID* a,
+  _In_ CONST VOID* b)
 {
   if (af == AF_INET6) {
     return IN6_ADDR_EQUAL((CONST IN6_ADDR*)a, (CONST IN6_ADDR*)b);
@@ -961,8 +961,8 @@
 MSTCPIP_INLINE
 BOOLEAN
 INET_IS_ADDR_UNSPECIFIED(
-  IN ADDRESS_FAMILY af,
-  IN CONST VOID* a)
+  _In_ ADDRESS_FAMILY af,
+  _In_ CONST VOID* a)
 {
   if (af == AF_INET6) {
     return IN6_IS_ADDR_UNSPECIFIED((CONST IN6_ADDR*)a);
@@ -975,8 +975,8 @@
 MSTCPIP_INLINE
 BOOLEAN
 INET_IS_UNALIGNED_ADDR_UNSPECIFIED(
-  IN ADDRESS_FAMILY af,
-  IN CONST VOID* a)
+  _In_ ADDRESS_FAMILY af,
+  _In_ CONST VOID* a)
 {
   if (af == AF_INET6) {
     return IN6_IS_ADDR_UNSPECIFIED((CONST IN6_ADDR*)a);
@@ -989,8 +989,8 @@
 MSTCPIP_INLINE
 BOOLEAN
 INET_IS_ADDR_LOOPBACK(
-  IN ADDRESS_FAMILY af,
-  IN CONST VOID* a)
+  _In_ ADDRESS_FAMILY af,
+  _In_ CONST VOID* a)
 {
   if (af == AF_INET6) {
     return IN6_IS_ADDR_LOOPBACK((CONST IN6_ADDR*)a);
@@ -1003,8 +1003,8 @@
 MSTCPIP_INLINE
 BOOLEAN
 INET_IS_ADDR_BROADCAST(
-  IN ADDRESS_FAMILY af,
-  IN CONST VOID* a)
+  _In_ ADDRESS_FAMILY af,
+  _In_ CONST VOID* a)
 {
   if (af == AF_INET6) {
     return FALSE;
@@ -1017,8 +1017,8 @@
 MSTCPIP_INLINE
 BOOLEAN
 INET_IS_ADDR_MULTICAST(
-  IN ADDRESS_FAMILY af,
-  IN CONST VOID* a)
+  _In_ ADDRESS_FAMILY af,
+  _In_ CONST VOID* a)
 {
   if (af == AF_INET6) {
     return IN6_IS_ADDR_MULTICAST((CONST IN6_ADDR*)a);
@@ -1031,7 +1031,7 @@
 MSTCPIP_INLINE
 CONST UCHAR*
 INET_ADDR_UNSPECIFIED(
-  IN ADDRESS_FAMILY af)
+  _In_ ADDRESS_FAMILY af)
 {
   if (af == AF_INET6) {
     return (CONST UCHAR*)&in6addr_any;
@@ -1044,9 +1044,9 @@
 MSTCPIP_INLINE
 VOID
 INET_SET_ADDRESS(
-  IN ADDRESS_FAMILY Family,
-  OUT PUCHAR Address,
-  IN CONST UCHAR *Value)
+  _In_ ADDRESS_FAMILY Family,
+  _Out_ PUCHAR Address,
+  _In_ CONST UCHAR *Value)
 {
   if (Family == AF_INET6) {
     *((PIN6_ADDR)Address) = *((PIN6_ADDR)Value);
@@ -1059,7 +1059,7 @@
 MSTCPIP_INLINE
 SIZE_T
 INET_ADDR_LENGTH(
-  IN ADDRESS_FAMILY af)
+  _In_ ADDRESS_FAMILY af)
 {
   if (af == AF_INET6) {
     return sizeof(IN6_ADDR);
@@ -1072,7 +1072,7 @@
 MSTCPIP_INLINE
 SIZE_T
 INET_SOCKADDR_LENGTH(
-  IN ADDRESS_FAMILY af)
+  _In_ ADDRESS_FAMILY af)
 {
   if (af == AF_INET6) {
     return sizeof(SOCKADDR_IN6);
@@ -1086,11 +1086,11 @@
 MSTCPIP_INLINE
 VOID
 INETADDR_SETSOCKADDR(
-  IN ADDRESS_FAMILY af,
-  OUT PSOCKADDR a,
-  IN CONST VOID* addr,
-  IN SCOPE_ID scope,
-  IN USHORT port)
+  _In_ ADDRESS_FAMILY af,
+  _Out_ PSOCKADDR a,
+  _In_ CONST VOID* addr,
+  _In_ SCOPE_ID scope,
+  _In_ USHORT port)
 {
   if (af == AF_INET6) {
     IN6ADDR_SETSOCKADDR((PSOCKADDR_IN6) a, (CONST IN6_ADDR *) addr, scope, port);
@@ -1105,7 +1105,7 @@
 MSTCPIP_INLINE
 VOID
 INETADDR_SETANY(
-  OUT PSOCKADDR a)
+  _Inout_ PSOCKADDR a)
 {
   if (a->sa_family == AF_INET6) {
     IN6ADDR_SETANY((PSOCKADDR_IN6)a);
@@ -1118,7 +1118,7 @@
 MSTCPIP_INLINE
 VOID
 INETADDR_SETLOOPBACK(
-  OUT PSOCKADDR a)
+  _Inout_ PSOCKADDR a)
 {
   if (a->sa_family == AF_INET6) {
     IN6ADDR_SETLOOPBACK((PSOCKADDR_IN6)a);
@@ -1131,7 +1131,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 INETADDR_ISANY(
-  IN CONST SOCKADDR *a)
+  _In_ CONST SOCKADDR *a)
 {
   if (a->sa_family == AF_INET6) {
     return IN6ADDR_ISANY((CONST SOCKADDR_IN6*)a);
@@ -1144,7 +1144,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 INETADDR_ISLOOPBACK(
-  IN CONST SOCKADDR *a)
+  _In_ CONST SOCKADDR *a)
 {
   if (a->sa_family == AF_INET6) {
     return IN6ADDR_ISLOOPBACK((CONST SOCKADDR_IN6*)a);
@@ -1156,7 +1156,8 @@
 
 MSTCPIP_INLINE
 BOOLEAN
-INETADDR_ISV4MAPPED(IN CONST SOCKADDR *a)
+INETADDR_ISV4MAPPED(
+  _In_ CONST SOCKADDR *a)
 {
   if (a->sa_family == AF_INET6) {
     return IN6ADDR_ISV4MAPPED((CONST SOCKADDR_IN6*)a);
@@ -1168,11 +1169,11 @@
 MSTCPIP_INLINE
 BOOLEAN
 NL_ADDR_EQUAL(
-  IN ADDRESS_FAMILY af,
-  IN SCOPE_ID sa,
-  IN CONST UCHAR* aa,
-  IN SCOPE_ID sb,
-  IN CONST UCHAR* ab)
+  _In_ ADDRESS_FAMILY af,
+  _In_ SCOPE_ID sa,
+  _In_ CONST UCHAR* aa,
+  _In_ SCOPE_ID sb,
+  _In_ CONST UCHAR* ab)
 {
   return (BOOLEAN)((sa.Value == sb.Value) && INET_ADDR_EQUAL(af, aa, ab));
 }
@@ -1180,9 +1181,9 @@
 MSTCPIP_INLINE
 BOOLEAN
 NL_IS_ADDR_UNSPECIFIED(
-  IN ADDRESS_FAMILY af,
-  IN SCOPE_ID s,
-  IN CONST UCHAR* a)
+  _In_ ADDRESS_FAMILY af,
+  _In_ SCOPE_ID s,
+  _In_ CONST UCHAR* a)
 {
   return (BOOLEAN)((s.Value == 0) && INET_IS_ADDR_UNSPECIFIED(af, a));
 }
@@ -1190,8 +1191,8 @@
 MSTCPIP_INLINE
 BOOLEAN
 INETADDR_ISEQUAL(
-  IN CONST SOCKADDR *a,
-  IN CONST SOCKADDR *b)
+  _In_ CONST SOCKADDR *a,
+  _In_ CONST SOCKADDR *b)
 {
   if (a->sa_family == AF_INET6) {
     return (BOOLEAN) (b->sa_family == AF_INET6 &&
@@ -1206,7 +1207,7 @@
 MSTCPIP_INLINE
 BOOLEAN
 INETADDR_ISUNSPECIFIED(
-  IN CONST SOCKADDR *a)
+  _In_ CONST SOCKADDR *a)
 {
   if (a->sa_family == AF_INET6) {
     return IN6ADDR_ISUNSPECIFIED((CONST SOCKADDR_IN6*)a);
@@ -1220,7 +1221,7 @@
 MSTCPIP_INLINE
 SCOPE_ID
 INETADDR_SCOPE_ID(
-  IN CONST SOCKADDR *a)
+  _In_ CONST SOCKADDR *a)
 {
   if (a->sa_family == AF_INET6) {
     return ((CONST SOCKADDR_IN6*)a)->sin6_scope_struct;
@@ -1234,7 +1235,7 @@
 MSTCPIP_INLINE
 USHORT
 INETADDR_PORT(
-  IN CONST SOCKADDR *a)
+  _In_ CONST SOCKADDR *a)
 {
   if (a->sa_family == AF_INET6) {
     return ((CONST SOCKADDR_IN6*)a)->sin6_port;
@@ -1247,7 +1248,7 @@
 MSTCPIP_INLINE
 PUCHAR
 INETADDR_ADDRESS(
-  IN CONST SOCKADDR* a)
+  _In_ CONST SOCKADDR* a)
 {
   if (a->sa_family == AF_INET6) {
     return (PUCHAR)&((PSOCKADDR_IN6)a)->sin6_addr;
@@ -1260,8 +1261,8 @@
 MSTCPIP_INLINE
 VOID
 INETADDR_SET_PORT(
-  IN OUT PSOCKADDR a,
-  IN USHORT Port)
+  _Inout_ PSOCKADDR a,
+  _In_ USHORT Port)
 {
   SS_PORT(a) = Port;
 }
@@ -1269,8 +1270,8 @@
 MSTCPIP_INLINE
 VOID
 INETADDR_SET_ADDRESS(
-  IN OUT PSOCKADDR a,
-  IN CONST UCHAR *Address)
+  _Inout_ PSOCKADDR a,
+  _In_ CONST UCHAR *Address)
 {
   if (a->sa_family == AF_INET6) {
     ((PSOCKADDR_IN6)a)->sin6_addr = *((CONST IN6_ADDR*)Address);
@@ -1283,9 +1284,9 @@
 MSTCPIP_INLINE
 VOID
 INET_UNCANONICALIZE_SCOPE_ID(
-  IN ADDRESS_FAMILY AddressFamily,
-  IN CONST UCHAR *Address,
-  IN OUT SCOPE_ID *ScopeId)
+  _In_ ADDRESS_FAMILY AddressFamily,
+  _In_ CONST UCHAR *Address,
+  _Inout_ SCOPE_ID *ScopeId)
 {
   if (AddressFamily == AF_INET6) {
     IN6_UNCANONICALIZE_SCOPE_ID((CONST IN6_ADDR*) Address, ScopeId);
@@ -1307,69 +1308,69 @@
 PSTR
 NTAPI
 RtlIpv4AddressToStringA(
-  IN const struct in_addr *Addr,
-  OUT PSTR S);
+  _In_ const struct in_addr *Addr,
+  _Out_writes_(16) PSTR S);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv4AddressToStringExA(
-  IN const struct in_addr *Address,
-  IN USHORT Port,
-  OUT PSTR AddressString,
-  IN OUT PULONG AddressStringLength);
+  _In_ const struct in_addr *Address,
+  _In_ USHORT Port,
+  _Out_writes_to_(*AddressStringLength, *AddressStringLength) PSTR AddressString,
+  _Inout_ PULONG AddressStringLength);
 
 NTSYSAPI
 PWSTR
 NTAPI
 RtlIpv4AddressToStringW(
-  IN const struct in_addr *Addr,
-  OUT PWSTR S);
+  _In_ const struct in_addr *Addr,
+  _Out_writes_(16) PWSTR S);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv4AddressToStringExW(
-  IN const struct in_addr *Address,
-  IN USHORT Port,
-  OUT PWSTR AddressString,
-  IN OUT PULONG AddressStringLength);
+  _In_ const struct in_addr *Address,
+  _In_ USHORT Port,
+  _Out_writes_to_(*AddressStringLength, *AddressStringLength) PWSTR AddressString,
+  _Inout_ PULONG AddressStringLength);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv4StringToAddressA(
-  IN PCSTR S,
-  IN BOOLEAN Strict,
-  OUT PCSTR *Terminator,
-  OUT struct in_addr *Addr);
+  _In_ PCSTR S,
+  _In_ BOOLEAN Strict,
+  _Out_ PCSTR *Terminator,
+  _Out_ struct in_addr *Addr);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv4StringToAddressExA(
-  IN PCSTR AddressString,
-  IN BOOLEAN Strict,
-  OUT struct in_addr *Address,
-  OUT PUSHORT Port);
+  _In_ PCSTR AddressString,
+  _In_ BOOLEAN Strict,
+  _Out_ struct in_addr *Address,
+  _Out_ PUSHORT Port);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv4StringToAddressW(
-  IN PCWSTR S,
-  IN BOOLEAN Strict,
-  OUT LPCWSTR *Terminator,
-  OUT struct in_addr *Addr);
+  _In_ PCWSTR S,
+  _In_ BOOLEAN Strict,
+  _Out_ LPCWSTR *Terminator,
+  _Out_ struct in_addr *Addr);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv4StringToAddressExW(
-  IN PCWSTR AddressString,
-  IN BOOLEAN Strict,
-  OUT struct in_addr *Address,
-  OUT PUSHORT Port);
+  _In_ PCWSTR AddressString,
+  _In_ BOOLEAN Strict,
+  _Out_ struct in_addr *Address,
+  _Out_ PUSHORT Port);
 
 #ifdef UNICODE
 #define RtlIpv4AddressToString RtlIpv4AddressToStringW
@@ -1391,69 +1392,69 @@
 PSTR
 NTAPI
 RtlIpv6AddressToStringA(
-  IN const struct in6_addr *Addr,
-  OUT PSTR S);
+  _In_ const struct in6_addr *Addr,
+  _Out_writes_(46) PSTR S);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv6AddressToStringExA(
-  IN const struct in6_addr *Address,
-  IN ULONG ScopeId,
-  IN USHORT Port,
-  OUT PSTR AddressString,
-  IN OUT PULONG AddressStringLength);
+  _In_ const struct in6_addr *Address,
+  _In_ ULONG ScopeId,
+  _In_ USHORT Port,
+  _Out_writes_to_(*AddressStringLength, *AddressStringLength) PSTR AddressString,
+  _Inout_ PULONG AddressStringLength);
 
 NTSYSAPI
 PWSTR
 NTAPI
 RtlIpv6AddressToStringW(
-  IN const struct in6_addr *Addr,
-  OUT PWSTR S);
+  _In_ const struct in6_addr *Addr,
+  _Out_writes_(46) PWSTR S);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv6AddressToStringExW(
-  IN const struct in6_addr *Address,
-  IN ULONG ScopeId,
-  IN USHORT Port,
-  OUT PWSTR AddressString,
-  IN OUT PULONG AddressStringLength);
+  _In_ const struct in6_addr *Address,
+  _In_ ULONG ScopeId,
+  _In_ USHORT Port,
+  _Out_writes_to_(*AddressStringLength, *AddressStringLength) PWSTR AddressString,
+  _Inout_ PULONG AddressStringLength);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv6StringToAddressA(
-  IN PCSTR S,
-  OUT PCSTR *Terminator,
-  OUT struct in6_addr *Addr);
+  _In_ PCSTR S,
+  _Out_ PCSTR *Terminator,
+  _Out_ struct in6_addr *Addr);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv6StringToAddressExA(
-  IN PCSTR AddressString,
-  OUT struct in6_addr *Address,
-  OUT PULONG ScopeId,
-  OUT PUSHORT Port);
+  _In_ PCSTR AddressString,
+  _Out_ struct in6_addr *Address,
+  _Out_ PULONG ScopeId,
+  _Out_ PUSHORT Port);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv6StringToAddressW(
-  IN PCWSTR S,
-  OUT PCWSTR *Terminator,
-  OUT struct in6_addr *Addr);
+  _In_ PCWSTR S,
+  _Out_ PCWSTR *Terminator,
+  _Out_ struct in6_addr *Addr);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlIpv6StringToAddressExW(
-  IN PCWSTR AddressString,
-  OUT struct in6_addr *Address,
-  OUT PULONG ScopeId,
-  OUT PUSHORT Port);
+  _In_ PCWSTR AddressString,
+  _Out_ struct in6_addr *Address,
+  _Out_ PULONG ScopeId,
+  _Out_ PUSHORT Port);
 
 #ifdef UNICODE
 #define RtlIpv6AddressToString RtlIpv6AddressToStringW
@@ -1478,31 +1479,31 @@
 PSTR
 NTAPI
 RtlEthernetAddressToStringA(
-  IN const DL_EUI48 *Addr,
-  OUT PSTR S);
+  _In_ const DL_EUI48 *Addr,
+  _Out_writes_(18) PSTR S);
 
 NTSYSAPI
 PWSTR
 NTAPI
 RtlEthernetAddressToStringW(
-  IN const DL_EUI48 *Addr,
-  OUT PWSTR S);
+  _In_ const DL_EUI48 *Addr,
+  _Out_writes_(18) PWSTR S);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlEthernetStringToAddressA(
-  IN PCSTR S,
-  OUT PCSTR *Terminator,
-  OUT DL_EUI48 *Addr);
+  _In_ PCSTR S,
+  _Out_ PCSTR *Terminator,
+  _Out_ DL_EUI48 *Addr);
 
 NTSYSAPI
 LONG
 NTAPI
 RtlEthernetStringToAddressW(
-  IN PCWSTR S,
-  OUT LPCWSTR *Terminator,
-  OUT DL_EUI48 *Addr);
+  _In_ PCWSTR S,
+  _Out_ LPCWSTR *Terminator,
+  _Out_ DL_EUI48 *Addr);
 
 #ifdef UNICODE
 #define RtlEthernetAddressToString RtlEthernetAddressToStringW