The WdfRequestGetCompletionParams method retrieves the I/O completion parameters that are associated with a specified framework request object.
VOID WdfRequestGetCompletionParams( [in] WDFREQUEST Request, [out] PWDF_REQUEST_COMPLETION_PARAMS Params );
- Request [in]
A handle to a framework request object.
- Params [out]
A pointer to a caller-supplied WDF_REQUEST_COMPLETION_PARAMS structure.
A bug check occurs if the driver supplies an invalid object handle.
After a driver has called WdfRequestSend to synchronously or asynchronously send an I/O request to an I/O target, and after the I/O target has completed the I/O request, the driver can call WdfRequestGetCompletionParams to obtain the I/O request's completion parameters.
Note that if your driver calls one of the methods that sends I/O requests to I/O targets only synchronously (such as WdfIoTargetSendReadSynchronously), the driver must not call WdfRequestGetCompletionParams.
The WdfRequestGetCompletionParams method copies the I/O request's completion parameters into the specified WDF_REQUEST_COMPLETION_PARAMS structure.
For more information about WdfRequestGetCompletionParams, see Completing I/O Requests.
The following code example initializes a WDF_REQUEST_COMPLETION_PARAMS structure and then calls WdfRequestGetCompletionParams.
WDF_REQUEST_COMPLETION_PARAMS completionParams; WDF_REQUEST_COMPLETION_PARAMS_INIT(&completionParams); WdfRequestGetCompletionParams( request, &completionParams );
|Available in version 1.0 and later versions of KMDF.|
|Wdf<MajorVersionNumber>000.sys (see Framework Library Versions.)|