WDS_IpcScanProcs()

DWORD DLLCALLCONV WDS_IpcScanProcs

(

_Outptr_ WDS_IPC_SCAN_RESULT *

pIpcScanResult

)

Scans and returns information of all registered processes that share the application process groupID (as was given to WDS_IpcRegister() or a specific groupID.)

Parameters

[out]

pIpcScanResult

Pointer to IpcScanResult struct that will be filled by the function.

Returns

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

// WinDriver Callback functions must use DLLCALLCONV macro
static void DLLCALLCONV ipc_msg_event_cb(WDS_IPC_MSG_RX *pIpcRxMsg, void *pData)
{
    printf("\n\nReceived an IPC message:\n"
        "msgID [0x%lx], msgData [0x%llx] from process [0x%lx]\n",
        pIpcRxMsg->dwMsgID, pIpcRxMsg->qwMsgData, pIpcRxMsg->dwSenderUID);
 
    switch (pIpcRxMsg->dwMsgID)
    {
    case A:
        {
            // ...
        }
        break;
 
    case B:
        {
            // ...
        }
        break;
 
    default:
        printf("Unknown IPC type. msgID [0x%lx], msgData [0x%llx] from "
            "process [0x%lx]\n\n", pIpcRxMsg->dwMsgID, pIpcRxMsg->qwMsgData,
            pIpcRxMsg->dwSenderUID);
    }
}
 
int main(void)
{
    DWORD dwSubGroupID = 0; // Or any other ID you want to choose
    DWORD dwStatus;
    WDS_IPC_SCAN_RESULT ipcScanResult;
 
    // Make sure to fully initialize WinDriver!
    if (!WD_DriverName(DEFAULT_DRIVER_NAME))
    {
        ErrLog("Failed to set the driver name for WDC library.\n");
        return;
    }
 
    /* Open a handle to the driver and initialize the WDC library */
    dwStatus = WDC_DriverOpen(WDC_DRV_OPEN_DEFAULT, DEFAULT_LICENSE_STRING);
    if (WD_STATUS_SUCCESS != dwStatus)
    {
        printf("Failed to initialize the WDC library. Error 0x%lx - %s\n",
            dwStatus, Stat2Str(dwStatus));
        return dwStatus;
    }
 
    dwStatus = WDS_IpcRegister(DEFAULT_PROCESS_NAME, DEFAULT_PROCESS_GROUP_ID,
        dwSubGroupID, WD_IPC_ALL_MSG, ipc_msg_event_cb, NULL /* Your cb ctx */);
    if (WD_STATUS_SUCCESS != dwStatus)
    {
        printf("Failed registering process to IPC. Error [0x%lx - %s]\n",
        dwStatus, Stat2Str(dwStatus));
        goto Exit;
    }
 
    printf("Registration completed successfully\n");
 
    printf("Scanning for processes...\n");
 
    dwStatus = WDS_IpcScanProcs(&ipcScanResult);
    if (WD_STATUS_SUCCESS != dwStatus)
    {
        printf("Failed scanning registered processes. Error [0x%lx - %s]\n",
            dwStatus, Stat2Str(dwStatus));
        goto Exit;
    }
 
    if (ipcScanResult.dwNumProcs)
    {
        printf("Found %ld processes in current group\n",
            ipcScanResult.dwNumProcs);
        for (i = 0; i < ipcScanResult.dwNumProcs; i++)
        {
            printf("  %lu) Name: %s, SubGroup ID: 0x%lx, UID: 0x%lx\n", i + 1,
                ipcScanResult.procInfo[i].cProcessName,
                ipcScanResult.procInfo[i].dwSubGroupID,
                ipcScanResult.procInfo[i].hIpc);
        }
    }
    else
    {
        printf("No processes found in current group\n");
    }
 
    // ...
    // Rest of your application code
    // ...
 
    dwStatus = WDS_IpcUnRegister();
    if (dwStatus)
    {
        printf("Failed unregistering IPC Error [0x%lx - %s]\n",
            dwStatus, Stat2Str(dwStatus));
        goto Exit;
    }
 
Exit:
    WDC_DriverClose();
}