Функция WdfPreDeviceRemove (wdfinstaller.h)

  • Статья

[Применяется только к KMDF]

Функция WdfPreDeviceRemove совместного установщика выполняет любые операции, которые могут потребоваться совместному установщику, прежде чем установщик драйвера без Plug and Play (PnP) удалит службу драйвера в режиме ядра.

Синтаксис

ULONG WdfPreDeviceRemove(
  [in]           LPCWSTR InfPath,
  [in, optional] LPCWSTR InfSectionName
);

Параметры

[in] InfPath

Указатель на строку расширенных символов, завершающуюся null, которая содержит путь к каталогу к INF-файлу драйвера. Установщик драйвера может получить эту строку, вызвав Метод GetCurrentDirectory, как описано в Microsoft Windows SDK.

[in, optional] InfSectionName

Указатель на строку расширенных символов, завершающуюся null, которая содержит имя Wdf-install-section в INF-файле драйвера. Дополнительные сведения об этом имени см. в разделе Использование совместного установщика KMDF. Если этот указатель имеет значение NULL, в совместном установщике для имени используется WdfSection .

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

WdfPreDeviceRemove возвращает ERROR_SUCCESS , если операция выполнена успешно. В противном случае функция возвращает одно из дополнительных значений ERROR_XXX , определенных в Winerror.h.

Комментарии

Установщик для драйверов на основе платформы устройства, отличного от PnP, должен вызвать WdfPreDeviceRemove , прежде чем установщик вызовет DeleteService.

Чтобы получить адрес функции WdfPreDeviceRemove совместного установщика, установщик должен вызвать GetProcAddress после того, как установщик вызвал LoadLibrary для загрузки совместного установщика.

Дополнительные сведения о функции WdfPreDeviceRemove и установщиках для драйверов на основе платформы для устройств, отличных от PnP, см. в статье Установка драйвера, отличного от PnP. Дополнительные сведения о DeleteService, GetProcAddress и LoadLibrary см. в документации по Microsoft Windows SDK.

Примеры

Пример кода, в котором используется функция WdfPreDeviceRemove , см. в установщике для примера NONPNP .

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfinstaller.h (включая Wdfinstaller.h)
Библиотека Н/Д (экспортируется библиотекой совместного установщика KMDF. Сведения об имени файла библиотеки совместного установщика см. в разделе Использование совместного установщика KMDF.)

См. также раздел

WdfPostDeviceRemove