Функция PoFxUnregisterDevice (wdm.h)

  • Статья

Подпрограмма PoFxUnregisterDevice удаляет регистрацию устройства из платформы управления питанием (PoFx).

Синтаксис

void PoFxUnregisterDevice(
  [in] POHANDLE Handle
);

Параметры

[in] Handle

Дескриптор, представляющий регистрацию устройства с помощью PoFx. Драйвер устройства ранее получил этот дескриптор из подпрограммы PoFxRegisterDevice .

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

None

Remarks

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

Чтобы отменить регистрацию устройства, драйвер вызывает PoFxUnregisterDevice во время обработки запроса IRP_MN_REMOVE_DEVICE или IRP_MN_SURPRISE_REMOVAL в зависимости от того, какой из них получен первым. Этот вызов должен выполняться после того, как драйверу больше не требуется доступ к оборудованию устройства.

Драйвер устройства, который вызывает эту подпрограмму, должен ранее вызывать подпрограмму PoFxRegisterDevice для регистрации устройства с помощью PoFx.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 8.
Целевая платформа Универсальное
Верхняя часть wdm.h
Библиотека Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL PASSIVE_LEVEL

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

IRP_MN_REMOVE_DEVICE

IRP_MN_SURPRISE_REMOVAL

PoFxRegisterDevice