функция WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN (wdfiotarget.h)

Статья
03/22/2025

[Применимо к KMDF и UMDF]

Функция WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN инициализирует структуру WDF_IO_TARGET_OPEN_PARAMS драйвера, чтобы драйвер смог повторно открыть удаленный целевой объект ввода-вывода.

Синтаксис

void WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN(
  [out] PWDF_IO_TARGET_OPEN_PARAMS Params
);

Параметры

[out] Params

Указатель на выделенную драйвером структуру WDF_IO_TARGET_OPEN_PARAMS, которая инициализирует функцию.

Возвращаемое значение

Нет

Замечания

Структура WDF_IO_TARGET_OPEN_PARAMS используется в качестве входных данных для метода WdfIoTargetOpen. Драйвер должен вызвать WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN, чтобы инициализировать структуру WDF_IO_TARGET_OPEN_PARAMS, если драйвер вызывает WdfIoTargetOpen из EvtIoTargetRemoveCanceled функции обратного вызова.

Функция WDF_IO_TARGET_OPEN_PARAMS_INIT_REOPEN ноль указанной структуры WDF_IO_TARGET_OPEN_PARAMS и задает элемент размера структуры. Затем функция задает элемент типаWdfIoTargetOpenReopen.

Дополнительные сведения о целевых объектах ввода-вывода см. в разделе Использование целевых объектов ввода-вывода.

Примеры

Следующий пример кода — это сегмент функции обратного вызова EvtIoTargetRemoveCanceled, которая повторно открывает удаленный целевой объект ввода-вывода.

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

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

Требования

Требование	Ценность
целевая платформа	универсальный
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
Заголовок	wdfiotarget.h (include Wdf.h)
IRQL	Любой уровень

См. также

EvtIoTargetRemoveCanceled

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetOpen

WdfIoTargetOpenReopen

Поделиться через