WDS_SharedIntEnable()

DWORD DLLCALLCONV WDS_SharedIntEnable	(	_In_ const CHAR *	pcProcessName,
		_In_ DWORD	dwGroupID,
		_In_ DWORD	dwSubGroupID,
		_In_ DWORD	dwAction,
		_In_ IPC_MSG_RX_HANDLER	pFunc,
		_In_ void *	pData
	)

Enables the shared interrupts mechanism of WinDriver.

If the mechanism is already enabled globally (for all processes) then the mechanism is enabled for the current process.

Parameters

[in]	pcProcessName	Optional process name string
[in]	dwGroupID	A unique group ID represent the specific application. Must be a positive ID
[in]	dwSubGroupID	Sub-group ID that should identify your user application type in case you have several types that may work simultaneously. Must be a positive ID
[in]	dwAction	IPC message type to receive, which can consist one of the enumeration values listed below: WD_IPC_UNICAST_MSG: Receive a message to a specific process with WinDriver IPC unique ID WD_IPC_MULTICAST_MSG: Receive a message from all processes that were registered with the same group ID as this process WD_IPC_ALL_MSG: Receive both types of the messages above
[in]	pFunc	A user-mode IPC message handler callback function, which will be called when a message was received by WinDriver from Shared Interrupts IPC process occurs. (See IPC_MSG_RX_HANDLER())
[in]	pData	Data for the user-mode IPC message handler callback routine (pFunc)

Returns

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

static void ipc_shared_int_msg_event_cb(WDS_IPC_MSG_RX *pIpcRxMsg, void *pData)
{
    printf("Shared Interrupt via IPC arrived:\nmsgID [0x%lx], msgData [0x%llx]"
        " from process [0x%lx]\n\n", pIpcRxMsg->dwMsgID, pIpcRxMsg->qwMsgData,
        pIpcRxMsg->dwSenderUID);
}
 
static DWORD IpcSharedIntsEnable(void)
{
    DWORD dwSubGroupID = 0; // Or any other you choose
    DWORD dwStatus;
 
    if (WDS_IsSharedIntsEnabledLocally())
    {
        printf("%s: Shared interrupts already enabled locally.\n",
            __FUNCTION__);
        return WD_OPERATION_ALREADY_DONE;
    }
 
 
    /* WDS_SharedIntEnable() is called in this sample with pFunc=
    ipc_shared_int_msg_event_cb. This will cause a shared interrupt to invoke
    both this callback and the callback passed to WDS_IpcRegister().
    To disable the "general" IPC callback, pass pFunc=NULL in the above
    mentioned call.
    Note you can replace pFunc here with your own callback especially designed
    to handle interrupts */
    dwStatus = WDS_SharedIntEnable(DEFAULT_SHARED_INT_NAME,
        DEFAULT_PROCESS_GROUP_ID, dwSubGroupID, WD_IPC_ALL_MSG,
        ipc_shared_int_msg_event_cb, NULL /* Your cb ctx */);
    if (WD_STATUS_SUCCESS != dwStatus)
    {
        printf("%s: Failed enabling shared interrupts via IPC. "
            "Error [0x%lx - %s]\n", __FUNCTION__, dwStatus, Stat2Str(dwStatus));
        return 0;
    }
 
    printf("Shared interrupts via IPC enabled successfully\n");
    return dwSubGroupID;
}