Función UcmUcsiConnectorCollectionCreate (ucmucsippm.h)

Crea un objeto de colección de conectores con UcmUcsiCx.

Sintaxis

NTSTATUS UcmUcsiConnectorCollectionCreate(
  [in]  WDFDEVICE                    WdfDevice,
  [in]  PWDF_OBJECT_ATTRIBUTES       Attributes,
  [out] UCMUCSI_CONNECTOR_COLLECTION *ConnectorCollection
);

Parámetros

[in] WdfDevice

Identificador de un objeto de dispositivo de marco que el controlador cliente recibió en la llamada anterior a WdfDeviceCreate.

[in] Attributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES proporcionada por el autor de la llamada que contiene atributos para el nuevo objeto de colección de conectores. Este parámetro es opcional y se puede WDF_NO_OBJECT_ATTRIBUTES.

[out] ConnectorCollection

Puntero a una ubicación que recibe un identificador para el nuevo objeto de colección de conectores.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método puede devolver un valor NTSTATUS adecuado.

Comentarios

El objeto de colección es necesario para crear un objeto Platform Policy Manager (PPM). El controlador de cliente crea el objeto llamando a UcmUcsiPpmCreate. El controlador no debe llamar a [UcmUcsiConnectorCollectionCreate] después de UcmUcsiPpmCreate porque no tendría ningún efecto en el objeto PPM ya existente.

El objeto de colección del conector está primario en el WDFOBJECT incluso cuando se llama a UcmUcsiConnectorCollectionCreate pasando WDF_NO_ATTRIBUTES. El marco administra la duración del objeto.

Requisitos

Requisito	Value
Versión mínima de KMDF	1.27
Versión mínima de UMDF	N/D
Encabezado	ucmucsippm.h (incluya UcmUcsiCx.h)
Library	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL

Consulte también

WdfDeviceCreate

WDF_OBJECT_ATTRIBUTES

UcmUcsiPpmCreate

UcmUcsiConnectorCollectionAddConnector