Метод IWDFRemoteTarget::Start (wudfddi.h)

Статья
02/07/2025

[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]

Метод IWDFRemoteTarget::Start перезапускает остановленный целевой объект удаленного ввода-вывода.

Синтаксис

HRESULT Start();

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

Запуск возвращает S_OK, если операция выполнена успешно. В противном случае метод может вернуть следующее значение:

Возвращаемый код	Описание
HRESULT_FROM_NT (STATUS_INVALID_DEVICE_STATE)	Удаленный целевой объект ввода-вывода был удален.

Этот метод может возвращать одно из других значений, содержащихся в Winerror.h.

Замечания

Метод start возобновляет обработку всех запросов ввода-вывода, которые находятся в очереди в удаленный целевой объект ввода-вывода. После вызова драйвера IWDFRemoteTarget::Stopдрайвер должен вызвать запустить, чтобы платформа может возобновить отправку запросов ввода-вывода в целевой объект ввода-вывода.

Дополнительные сведения о запускеи использовании удаленных целевых объектов ввода-вывода в драйверах на основе UMDF см. в статье Управление состоянием общего объекта ввода-вывода вUMDF.

Примеры

В следующем примере кода перезапускается удаленный целевой объект ввода-вывода.

if (S_OK == RemoteTarget->Start())
{
    //
    // Resume sending I/O requests to the I/O target.
    //
...}

Требования

Требование	Ценность
завершение поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа	Настольный
минимальная версия UMDF	1.9
заголовка	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

См. также

IWDFRemoteTarget

IWDFRemoteTarget::Stop

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