Функция UcmUcsiPpmCreate (Ucmucsippm.h)

Создает объект диспетчера политик платформы (PPM).

Синтаксис

NTSTATUS UcmUcsiPpmCreate(
  [in]  WDFDEVICE              WdfDevice,
  [in]  PUCMUCSI_PPM_CONFIG    Config,
  [in]  PWDF_OBJECT_ATTRIBUTES Attributes,
  [out] UCMUCSIPPM             *PPMObject
);

Параметры

[in] WdfDevice

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

[in] Config

Указатель на структуру UCMUCSI_PPM_CONFIG , предоставляемую вызывающим абонентом, которая инициализирована путем вызова UCMUCSI_PPM_CONFIG_INIT. Элемент ConnectorCollectionHandle должен иметь дескриптор, полученный при предыдущем вызове UcmUcsiConnectorCollectionCreate.

[in] Attributes

Указатель на предоставленную вызывающим WDF_OBJECT_ATTRIBUTES структуру, содержащую атрибуты для нового объекта коллекции соединителей. Этот параметр является необязательным и может быть WDF_NO_OBJECT_ATTRIBUTES.

[out] PPMObject

Указатель на расположение, которое получает дескриптор нового объекта PPM.

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

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

Комментарии

Драйвер клиента должен вызывать UcmUcsiPpmCreate из функции обратного вызова EVT_WDF_DEVICE_PREPARE_HARDWARE .

Структура, передаваемая в конфигурации , содержит сведения о соединителе Type-C, необходимые для создания соединителей с расширением класса соединителей USB Type-C (UcmCx) с помощью UcmConnectorCreate и недоступны для получения из PPM с помощью команд UCSI, таких как GetCapability или GetConnectorCapability.

Структура Config также содержит идентификаторы соединителей, необходимые для сопоставления "один к одному" между соединителями USB Type-C и USB-портами.

Объект PPM также является WDFOBJECT и создает связь "один к одному" с дескриптором WDFDEVICE, предоставляемым драйвером клиента.

Объект PPM является родительским объектом WDFOBJECT даже при вызове UcmUcsiPpmCreate путем передачи WDF_NO_ATTRIBUTES. Время существования объекта управляется платформой.

Требования

Требование	Значение
Минимальная версия KMDF	1.27
Минимальная версия UMDF	Н/Д
Верхняя часть	Ucmucsippm.h (включая UcmUcsiCx.h)
Библиотека	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL