WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// wdfiotarget.h

VOID WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN(
  [out] PWDF_IO_TARGET_OPEN_PARAMS Params
);

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-wdfiotarget-wdf_io_target_open_params_init_reopen)

WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN function

Description

[Applies to KMDF and UMDF]

The WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN function initializes a driver's WDF_IO_TARGET_OPEN_PARAMS structure so the driver can reopen a remote I/O target.

Parameters

Params [out]

A pointer to a driver-allocated WDF_IO_TARGET_OPEN_PARAMS structure, which the function initializes.

Remarks

The WDF_IO_TARGET_OPEN_PARAMS structure is used as input to the WdfIoTargetOpen method. Your driver should call WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN to initialize a WDF_IO_TARGET_OPEN_PARAMS structure if the driver is calling WdfIoTargetOpen from within an EvtIoTargetRemoveCanceled callback function.

The WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN function zeros the specified WDF_IO_TARGET_OPEN_PARAMS structure and sets the structure's Size member. Then, the function sets the Type member to WdfIoTargetOpenReopen.

For more information about I/O targets, see Using I/O Targets.

Examples

The following code example is a segment of an EvtIoTargetRemoveCanceled callback function that reopens a remote I/O target.

VOID
MyEvtIoTargetRemoveCanceled(
    WDFIOTARGET IoTarget
    )
{
    WDF_IO_TARGET_OPEN_PARAMS openParams;
    NTSTATUS status;

...
    WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN(&openParams);
    status = WdfIoTargetOpen(
                             IoTarget,
                             &openParams
                             );
...
}

See also

EvtIoTargetRemoveCanceled

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetOpen

WdfIoTargetOpenReopen