функция обратного вызова D3COLD_REQUEST_PERST_DELAY (wdm.h)

Статья
02/07/2025

Позволяет объекту устройства-функции (FDO) передавать его требование к фиксированному времени задержки между сообщением PME_TO_Ack получается в порте нижестоящего порта PCI Express, который вызвал сообщение PME_Turn_Off, и время, когда платформа утверждает PERST# в слот во время перехода соответствующей конечной точки или pci Express Upstream Port на D3cold, пока система находится в рабочем состоянии ACPI.

Синтаксис

D3COLD_REQUEST_PERST_DELAY D3coldRequestPerstDelay;

NTSTATUS D3coldRequestPerstDelay(
  [_In_reads_opt_(_Inexpressible_("varies"))] PVOID Context,
  [_In_]                                      ULONG DelayInMicroSeconds
)
{...}

Параметры

Context

Дескриптор устройства.

[_In_] DelayInMicroSeconds

Задержка в единицах микросекунда. Максимальное значение равно 10000 микросекундам.

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

Возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае верните соответствующий код ошибки ЗНАЧЕНИй NTSTATUS. Дополнительные сведения см. в значения NTSTATUS.

Замечания

Драйвер устройства, который успешно запрашивает интерфейс GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE, получает указатель на структуру D3COLD_AUX_POWER_AND_TIMING_INTERFACE, в которой драйвер задает элементу RequestPerstDelay указатель на реализацию функции обратного вызова D3COLD_REQUEST_PERST_DELAY.

Для устройства с несколькими функциями разрешено вызывать эту подпрограмму только функцией 0.
Функция 0 должна находиться в D0 при вызове этой подпрограммы.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1803
заголовка	wdm.h (include Wdm.h)

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