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

Статья
08/07/2023

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

Синтаксис

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

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