WdfPdoInitAllowForwardingRequestToParent function (wdfpdo.h)

[Applies to KMDF only]

The WdfPdoInitAllowForwardingRequestToParent method enables a driver's ability to call WdfRequestForwardToParentDeviceIoQueue.

Syntax

void WdfPdoInitAllowForwardingRequestToParent(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parameters

[in] DeviceInit

A pointer to a WDFDEVICE_INIT structure.

Return value

None

Remarks

If your driver uses WdfRequestForwardToParentDeviceIoQueue to requeue I/O requests from a child device's I/O queue to a parent device's I/O queue, the driver must call WdfPdoInitAllowForwardingRequestToParent before it calls WdfDeviceCreate to create a physical device object (PDO) for the child device. For more information about calling WdfDeviceCreate, see Creating a Framework Device Object.

For more information about WdfPdoInitAllowForwardingRequestToParent and WdfRequestForwardToParentDeviceIoQueue, see Requeuing I/O Requests.

Examples

The following code example enables a driver's ability to call WdfRequestForwardToParentDeviceIoQueue.

WdfPdoInitAllowForwardingRequestToParent(pDeviceInit);

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.9
Header wdfpdo.h (include Wdf.h)
Library Wdf01000.sys (see Framework Library Versioning.)
IRQL PASSIVE_LEVEL
DDI compliance rules DriverCreate(kmdf)

See also

WdfRequestForwardToParentDeviceIoQueue