Функция UcmUcsiConnectorCollectionCreate (ucmucsippm.h)
Создает объект коллекции соединителей с UcmUcsiCx.
Синтаксис
NTSTATUS UcmUcsiConnectorCollectionCreate(
[in] WDFDEVICE WdfDevice,
[in] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] UCMUCSI_CONNECTOR_COLLECTION *ConnectorCollection
);
Параметры
[in] WdfDevice
Дескриптор объекта устройства платформы, который драйвер клиента получил в предыдущем вызове WdfDeviceCreate.
[in] Attributes
Указатель на структуру, предоставляемую вызывающим WDF_OBJECT_ATTRIBUTES, которая содержит атрибуты для нового объекта коллекции соединителей. Этот параметр является необязательным и может быть WDF_NO_OBJECT_ATTRIBUTES.
[out] ConnectorCollection
Указатель на расположение, которое получает дескриптор к новому объекту коллекции соединителей.
Возвращаемое значение
Возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае этот метод может вернуть соответствующее значение NTSTATUS.
Замечания
Объект коллекции необходим для создания объекта Диспетчера политик платформы (PPM). Драйвер клиента создает объект, вызывая UcmUcsiPpmCreate. Драйвер не должен вызывать [UcmUcsiConnectorCollectionCreate] после UcmUcsiPpmCreate, так как он не будет влиять на уже существующий объект PPM.
Объект коллекции соединителей является родительским для WDFOBJECT, даже если метод UcmUcsiConnectorCollectionCreate вызывается путем передачи WDF_NO_ATTRIBUTES. Время существования объекта управляется платформой.
Требования
| Требование | Ценность |
|---|---|
| минимальная версия KMDF | 1.27 |
| минимальная версия UMDF | N/A |
| заголовка | ucmucsippm.h (включая UcmUcsiCx.h) |
| библиотеки | UcmUcsiCxStub.lib |
| IRQL | PASSIVE_LEVEL |