WDC_EventUnregister()

DWORD DLLCALLCONV WDC_EventUnregister

(

_In_ WDC_DEVICE_HANDLE

hDev

)

Unregisters an application from a receiving Plug-and-Play and power management notifications for a device, pursuant to a previous call to WDC_EventRegister()

Parameters

[in]

hDev

Handle to a Plug-and-Play WDC device, returned by WDC_PciDeviceOpen()

Returns

Returns WD_STATUS_SUCCESS (0) on success, or an appropriate error code otherwise

//WinDriver Callback functions must use DLLCALLCONV macro
static void DLLCALLCONV EventHandlerExample(WDC_DEVICE_HANDLE hDev,
    DWORD dwAction)
{
 
    printf("\nReceived event notification (device handle 0x%p): ", hDev);
    switch (dwAction)
    {
    case WD_INSERT:
        printf("WD_INSERT\n");
        break;
    case WD_REMOVE:
        printf("WD_REMOVE\n");
        break;
    case WD_POWER_CHANGED_D0:
        printf("WD_POWER_CHANGED_D0\n");
        break;
    case WD_POWER_CHANGED_D1:
        printf("WD_POWER_CHANGED_D1\n");
        break;
    case WD_POWER_CHANGED_D2:
        printf("WD_POWER_CHANGED_D2\n");
        break;
    case WD_POWER_CHANGED_D3:
        printf("WD_POWER_CHANGED_D3\n");
        break;
    case WD_POWER_SYSTEM_WORKING:
        printf("WD_POWER_SYSTEM_WORKING\n");
        break;
    case WD_POWER_SYSTEM_SLEEPING1:
        printf("WD_POWER_SYSTEM_SLEEPING1\n");
        break;
    case WD_POWER_SYSTEM_SLEEPING2:
        printf("WD_POWER_SYSTEM_SLEEPING2\n");
        break;
    case WD_POWER_SYSTEM_SLEEPING3:
        printf("WD_POWER_SYSTEM_SLEEPING3\n");
        break;
    case WD_POWER_SYSTEM_HIBERNATE:
        printf("WD_POWER_SYSTEM_HIBERNATE\n");
        break;
    case WD_POWER_SYSTEM_SHUTDOWN:
        printf("WD_POWER_SYSTEM_SHUTDOWN\n");
        break;
    default:
        printf("0x%lx\n", dwAction);
        break;
    }
}
 
DWORD EventRegisterExample(WDC_DEVICE_HANDLE hDev)
{
    DWORD dwStatus;
    DWORD dwActions = WD_ACTIONS_ALL;
 
    /* Check whether the event is already registered */
    if (WDC_EventIsRegistered(hDev))
    {
        return WD_OPERATION_ALREADY_DONE;
    }
 
    /* Register the event */
    dwStatus = WDC_EventRegister(hDev, dwActions, EventHandlerExample, hDev,
        WDC_IS_KP(hDev));
 
    if (WD_STATUS_SUCCESS != dwStatus)
    {
        printf("Failed to register events. Error 0x%lx - %s\n",
            dwStatus, Stat2Str(dwStatus));
        return dwStatus;
    }
 
    printf("Events registered\n");
 
    // ...
    // Some more code
    // ...
 
    /* Cleanup */
    dwStatus = WDC_EventUnregister(hDev);
 
    return dwStatus;
}