Sample Code
Windows Driver Samples/ Windows Filtering Platform Sample/ C++/ sys/ Framework_PowerStates.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 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 | //////////////////////////////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2012 Microsoft Corporation. All Rights Reserved. // // Module Name: // Framework_PowerStates.cpp // // Abstract: // // Author: // Dusty Harper (DHarper) // // Revision History: // // [ Month ][Day] [Year] - [Revision]-[ Comments ] // May 01, 2010 - 1.0 - Creation // //////////////////////////////////////////////////////////////////////////////////////////////////// #include "Framework_WFPSamplerCalloutDriver.h" /// . #include "Framework_PowerStates.tmh" /// $(OBJ_PATH)\$(O)\ /** @framework_function="PowerStateCallback" Purpose: Callback which handles various power state transitions for the callout driver. <br> <br> Notes: <br> <br> MSDN_Ref: <br> */ _IRQL_requires_same_ _Function_class_(CALLBACK_FUNCTION) VOID PowerStateCallback(_In_ VOID * pCallbackContext, _In_ VOID * pPowerStateEvent, _In_ VOID * pEventSpecifics) { #if DBG DbgPrintEx(DPFLTR_IHVNETWORK_ID, DPFLTR_INFO_LEVEL, " ---> PowerStateCallback()\n" ); #endif /// DBG UNREFERENCED_PARAMETER(pCallbackContext); if (pPowerStateEvent == ( VOID *)PO_CB_SYSTEM_STATE_LOCK) { NTSTATUS status = STATUS_SUCCESS; if (pEventSpecifics) { /// entering the ON state (S0), so return operation to normal if (g_calloutsRegistered == FALSE) { status = KrnlHlprExposedCalloutsRegister(); HLPR_BAIL_ON_FAILURE(status); g_calloutsRegistered = TRUE; } } else { /// leaving the ON state (S0) to sleep (S1/S2/S3) or hibernate (S4) /// Unregister the callouts so no more injection will take place. By default, the filters /// invoking the callouts will return block. if (g_calloutsRegistered == TRUE) { status = KrnlHlprExposedCalloutsUnregister(); HLPR_BAIL_ON_FAILURE(status); g_calloutsRegistered = FALSE; } } } HLPR_BAIL_LABEL: #if DBG DbgPrintEx(DPFLTR_IHVNETWORK_ID, DPFLTR_INFO_LEVEL, " <--- PowerStateCallback()\n" ); #endif /// DBG return ; } /** @framework_function="RegisterPowerStateChangeCallback" Purpose: Unregister a callback that handled notifications of power state changes. <br> <br> Notes: <br> <br> MSDN_Ref: HTTP://MSDN.Microsoft.com/En-US/Library/FF545649.aspx <br> */ _IRQL_requires_min_(PASSIVE_LEVEL) _IRQL_requires_max_(APC_LEVEL) _IRQL_requires_same_ VOID UnregisterPowerStateChangeCallback(_Inout_ DEVICE_EXTENSION* pDeviceExtension) { #if DBG DbgPrintEx(DPFLTR_IHVNETWORK_ID, DPFLTR_INFO_LEVEL, " ---> UnregisterPowerStateChangeCallback()\n" ); #endif /// DBG NT_ASSERT(pDeviceExtension); if (pDeviceExtension->pRegistration) { ExUnregisterCallback(pDeviceExtension->pRegistration); pDeviceExtension->pRegistration = 0; } if (pDeviceExtension->pCallbackObject) { ObDereferenceObject(pDeviceExtension->pCallbackObject); pDeviceExtension->pCallbackObject = 0; } #if DBG DbgPrintEx(DPFLTR_IHVNETWORK_ID, DPFLTR_INFO_LEVEL, " <--- UnregisterPowerStateChangeCallback()\n" ); #endif /// DBG return ; } /** @framework_function="RegisterPowerStateChangeCallback" Purpose: Create and register a callback to handle notifications of power state changes. <br> <br> Notes: <br> <br> MSDN_Ref: HTTP://MSDN.Microsoft.com/En-US/Library/FF544560.aspx <br> */ _IRQL_requires_min_(PASSIVE_LEVEL) _IRQL_requires_max_(APC_LEVEL) _IRQL_requires_same_ _Success_( return == STATUS_SUCCESS) NTSTATUS RegisterPowerStateChangeCallback(_Inout_ DEVICE_EXTENSION* pDeviceExtension) { #if DBG DbgPrintEx(DPFLTR_IHVNETWORK_ID, DPFLTR_INFO_LEVEL, " ---> RegisterPowerStateChangeCallback()\n" ); #endif /// DBG NT_ASSERT(pDeviceExtension); NTSTATUS status = STATUS_SUCCESS; OBJECT_ATTRIBUTES objectAttributes = {0}; UNICODE_STRING unicodeString = {0}; RtlInitUnicodeString(&unicodeString, L "\\Callback\\PowerState" ); InitializeObjectAttributes(&objectAttributes, &unicodeString, OBJ_CASE_INSENSITIVE, 0, 0); status = ExCreateCallback(&(pDeviceExtension->pCallbackObject), &objectAttributes, FALSE, /// Do not create as the system should already have done this TRUE); /// Allow multiple callbacks if (status != STATUS_SUCCESS) { DbgPrintEx(DPFLTR_IHVNETWORK_ID, DPFLTR_ERROR_LEVEL, " !!!! RegisterPowerStateChangeCallback : ExCreateCallback() [status: %#x]\n" , status); HLPR_BAIL; } pDeviceExtension->pRegistration = ExRegisterCallback(pDeviceExtension->pCallbackObject, PowerStateCallback, pDeviceExtension); HLPR_BAIL_LABEL: #if DBG DbgPrintEx(DPFLTR_IHVNETWORK_ID, DPFLTR_INFO_LEVEL, " <--- RegisterPowerStateChangeCallback() [status: %#x]\n" , status); #endif /// DBG return status; } |
Our Services
-
What our customers say about us?
Read our customer testimonials to find out why our clients keep returning for their projects.
View Testimonials