Макрос WdfDeviceStopIdleWithTag (wdfdevice.h)

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

Макрос WdfDeviceStopIdleWithTag увеличивает число ссылок на питание для указанного объекта устройства платформы и назначает текущему имени файла и номеру строки драйвера ссылке. Макрос также назначает значение тега ссылке.

Синтаксис

NTSTATUS WdfDeviceStopIdleWithTag(
    _In_ WDFDEVICE Device,
    _In_ BOOLEAN WaitForD0,
    _In_ PVOID Tag
);

Параметры

[in] Device

Дескриптор объекта устройства платформы.

[in] WaitForD0

Логическое значение, указывающее, когда WdfDeviceStopIdleWithTag возвращается. Если TRUE, он возвращается только после того, как указанное устройство ввело состояние питания устройства D0. Если FALSE, метод возвращается немедленно.

[in] Tag

Определяемое драйвером значение, которое платформа сохраняет в качестве тега идентификации для ссылки на питание.

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

Нет

Замечания

Если операция выполнена успешно, WdfDeviceStopIdleWithTag возвращает STATUS_SUCCESS.

К дополнительным возвращаемым значениям относятся:

Метод может возвращать другие значения NTSTATUS.

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Если драйвер вызывает WdfDeviceStopIdleWithTag для увеличения количества ссылок, драйвер должен вызвать WdfDeviceResumeIdleWithTag для уменьшения количества.

Вызов WdfDeviceStopIdleWithTag вместо WdfDeviceStopIdle предоставляет дополнительные сведения (значение тега, номер строки и имя файла), которые можно просмотреть в отладчиках Майкрософт. WdfDeviceStopIdleWithTag использует текущий номер строки и имя файла драйвера.

Значения тегов, номеров строк и имени файла можно просмотреть с помощью расширения отладчика !wdftagtracker. Расширение отладчика отображает значение тега как указатель, так и ряд символов.

Используйте !wdfkd.wdfdevice с подробными флагами и найдите ссылку на !wdftagtracker в выходных данных:

kd> !wdfdevice <handle> f 

Требования

См. также

отладка утечки power Reference в WDF

WdfDeviceResumeIdle

WdfDeviceResumeIdleWithTag

WdfDeviceStopIdle