Функция 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 Н/Д
Верхняя часть ucmucsippm.h (включая UcmUcsiCx.h)
Библиотека UcmUcsiCxStub.lib
IRQL PASSIVE_LEVEL

См. также раздел

WdfDeviceCreate

WDF_OBJECT_ATTRIBUTES

UcmUcsiPpmCreate

UcmUcsiConnectorCollectionAddConnector