WD_KernelPlugInCall

#define WD_KernelPlugInCall	(		h,
			pKernelPlugInCall
	)

Value:

    WD_FUNCTION(IOCTL_WD_KERNEL_PLUGIN_CALL, h, pKernelPlugInCall, \
        sizeof(WD_KERNEL_PLUGIN_CALL), FALSE)

Calls a routine in the Kernel PlugIn to be executed.

Parameters

[in]	h	Handle to WinDriver's kernel-mode driver as received from WD_Open()
[in,out]	pKernelPlugInCall	Pointer to Kernel PlugIn information structure

Returns

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

Remarks

Calling the WD_KernelPlugInCall() function 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));
}

Definition at line 2593 of file windrvr.h.