Calls a routine in the Kernel PlugIn to be executed.

DWORD WD_KernelPlugInCall(
    HANDLE hWD,
    WD_KERNEL_PLUGIN_CALL *pKernelPlugInCall);

Returns WD_STATUS_SUCCESS (0) on success, or an appropriate error code otherwise [A].

Calling the WD_KernelPlugInCall() function [6.3] in the user mode will call your KP_Call callback function in the kernel. The KP_Call Kernel PlugIn function will determine what routine to execute according to the message passed to it in the WD_KERNEL_PLUGIN_CALL structure.

WD_KERNEL_PLUGIN_CALL kpCall;

BZERO (kpCall);
/* Prepare the kpCall structure from WD_KernelPlugInOpen(): */
kpCall.hKernelPlugIn = hKernelPlugIn;
/* Set the message to pass to KP_Call. This will determine
   the action performed in the kernel: */
kpCall.dwMessage = MY_DRV_MSG;

kpCall.pData = &mydrv; /* The data to pass to the Kernel PlugIn */
dwStatus = WD_KernelPlugInCall(hWD, &kpCall);
if (dwStatus == WD_STATUS_SUCCESS)
{
    printf("Result = 0x%x\n", kpCall.dwResult);
}
else
{
    printf("WD_KernelPlugInCall() failed. Error: 0x%x (%s)\n",
            dwStatus, Stat2Str(dwStatus));
}