Sample Code

Windows Driver Samples/ Windows Filtering Platform Sample/ C++/ syslib/ HelperFunctions_NetBuffer.cpp/

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
////////////////////////////////////////////////////////////////////////////////////////////////////
//
//   Copyright (c) 2012 Microsoft Corporation.  All Rights Reserved.
//
//   Module Name:
//      HelperFunctions_NetBuffer.cpp
//
//   Abstract:
//      This module contains kernel helper functions that assist with NET_BUFFER and NET_BUFFER_LIST.
//
//   Naming Convention:
//
//      <Module><Object><Action><Modifier>
// 
//      i.e.
//
//       KrnlHlprNBLGetRequiredRefCount
//
//       <Module>
//          KrnlHlpr           -       Function is located in syslib\ and applies to kernel mode.
//       <Object>
//          NBL                -       Function pertains to NET_BUFFER_LIST objects.
//       <Action>
//          {
//            Get              -       Function retrieves data.
//          }
//       <Modifier>
//          {
//            RequiredRefCount -       Function returns a refCount for the NBL / NBL chain.
//          }
//
//   Private Functions:
//
//   Public Functions:
//      KrnlHlprNBLGetRequiredRefCount(),
//
//   Author:
//      Dusty Harper      (DHarper)
//
//   Revision History:
//
//      [ Month ][Day] [Year] - [Revision]-[ Comments ]
//      May       01,   2010  -     1.0   -  Creation
//
////////////////////////////////////////////////////////////////////////////////////////////////////
 
#include "HelperFunctions_Include.h"     /// .
#include "HelperFunctions_NetBuffer.tmh" /// $(OBJ_PATH)\$(O)\
 
/**
 @kernel_helper_function="KrnlHlprNBLGetRequiredRefCount"
  
   Purpose:  Return a count of how many NBLs are within the NBL chain.                          <br>
                                                                                                <br>
   Notes:                                                                                       <br>
                                                                                                <br>
   MSDN_Ref:                                                                                    <br>
*/
_IRQL_requires_min_(PASSIVE_LEVEL)
_IRQL_requires_max_(DISPATCH_LEVEL)
_IRQL_requires_same_
UINT32 KrnlHlprNBLGetRequiredRefCount(_In_ const NET_BUFFER_LIST* pNBL,
                                      _In_ BOOLEAN isChained)           /* FALSE */
{
#if DBG
    
   DbgPrintEx(DPFLTR_IHVNETWORK_ID,
              DPFLTR_INFO_LEVEL,
              " ---> KrnlHlprNBLGetRequiredRefCount()\n");
 
#endif /// DBG
 
   NT_ASSERT(pNBL);
 
   UINT32 requiredRefCount = 0;
 
   if(isChained)
   {
      for(NET_BUFFER_LIST* pCurrentNBL = (NET_BUFFER_LIST*)pNBL;
          pCurrentNBL;
          pCurrentNBL = NET_BUFFER_LIST_NEXT_NBL(pCurrentNBL))
      {
         requiredRefCount++;
      }
   }
   else
      requiredRefCount = 1;
 
#if DBG
    
   DbgPrintEx(DPFLTR_IHVNETWORK_ID,
              DPFLTR_INFO_LEVEL,
              " <--- KrnlHlprNBLGetRequiredRefCount() [refCount: %#d]\n",
              requiredRefCount);
 
#endif /// DBG
    
   return requiredRefCount;
}

Our Services

  • What our customers say about us?

© 2011-2025 All Rights Reserved. Joya Systems. 4425 South Mopac Building II Suite 101 Austin, TX 78735 Tel: 800-DEV-KERNEL

Privacy Policy. Terms of use. Valid XHTML & CSS