функция UsbPm_RetrieveConnectorState (usbpmapi.h)

Извлекает текущее состояние соединителя. В отличие от свойств соединителя, сведения о состоянии являются динамическими, которые могут изменяться во время выполнения.

Синтаксис

NTSTATUS UsbPm_RetrieveConnectorState(
  [In]  USBPM_CLIENT           ClientHandle,
  [In]  USBPM_CONNECTOR        ConnectorHandle,
  [Out] PUSBPM_CONNECTOR_STATE ConnectorState
);

Параметры

[In] ClientHandle

Дескриптор, полученный драйвером клиента в предыдущем вызове UsbPm_Register.

[In] ConnectorHandle

Дескриптор соединителя, предоставляемый диспетчером политик при вызове реализации драйвера EVT_USBPM_EVENT_CALLBACK. Дескриптор задается в элементе EventData.ConnectorStateChange.ConnectorHandle элемента значения Params.

[Out] ConnectorState

Указатель на структуру, предоставляемую драйвером, USBPM_CONNECTOR_STATE, которая получает состояние соединителя. Инициализация структуры путем вызова USBPM_CONNECTOR_STATE_INIT.

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

Возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае возвращает соответствующее значение NTSTATUS.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 10 версии 1809
минимальная версия KMDF 1.27
минимальная версия UMDF 2.27
заголовка usbpmapi.h
библиотеки UsbPmApi.lib
IRQL PASSIVE_LEVEL

См. также

UsbPm_Register

EVT_USBPM_EVENT_CALLBACK