WdfRequestGetParameters function (wdfrequest.h)

[Applies to KMDF and UMDF]

The WdfRequestGetParameters method retrieves the parameters that are associated with a specified framework request object.

Syntax

void WdfRequestGetParameters(
  [in]      WDFREQUEST              Request,
  [in, out] PWDF_REQUEST_PARAMETERS Parameters
);

Parameters

[in] Request

A handle to a framework request object.

[in, out] Parameters

A pointer to a caller-allocated WDF_REQUEST_PARAMETERS structure that the WDF_REQUEST_PARAMETERS_INIT routine initialized and filled in.

Return value

None

Remarks

A bug check occurs if the driver supplies an invalid object handle.

A driver cannot retrieve parameters from a driver-created request by calling WdfRequestGetParameters because the framework does not allocate a stack location for the current driver.

For more information about WdfRequestGetParameters, see Obtaining Information About an I/O Request.

Examples

For a code example that uses WdfRequestGetParameters, see WdfRequestComplete.

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Minimum UMDF version 2.0
Header wdfrequest.h (include Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI compliance rules DriverCreate(kmdf), evtioresumegetparam, EvtIoResumeGetParam(kmdf), evtiostopgetparam, EvtIoStopGetParam(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

See also

WDF_REQUEST_PARAMETERS

WDF_REQUEST_PARAMETERS_INIT

WdfRequestWdmGetIrp