Expand Minimize

WdfRequestGetParameters method

[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,
  [out]  PWDF_REQUEST_PARAMETERS Parameters
);

Parameters

Request [in]

A handle to a framework request object.

Parameters [out]

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

Return value

None.

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

Remarks

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

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, evtioresumegetparam, evtiostopgetparam, InvalidReqAccess, InvalidReqAccessLocal, KmdfIrql, KmdfIrql2

See also

WdfRequestWdmGetIrp
WDF_REQUEST_PARAMETERS_INIT
WDF_REQUEST_PARAMETERS

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.