Partager via


UcmUcsiConnectorCollectionCreate, fonction (ucmucsippm.h)

Crée un objet de collection de connecteurs avec UcmUcsiCx.

Syntaxe

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

Paramètres

[in] WdfDevice

Handle d’un objet d’appareil framework que le pilote client a reçu lors de l’appel précédent à WdfDeviceCreate.

[in] Attributes

Pointeur vers une structure de WDF_OBJECT_ATTRIBUTES fournie par l’appelant qui contient des attributs pour le nouvel objet de collection de connecteurs. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

[out] ConnectorCollection

Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet de collection de connecteurs.

Valeur retournée

Retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner une valeur NTSTATUS appropriée.

Remarques

L’objet de collection est requis pour créer un objet Ppm (Platform Policy Manager). Le pilote client crée l’objet en appelant UcmUcsiPpmCreate. Le pilote ne doit pas appeler [UcmUcsiConnectorCollectionCreate] après UcmUcsiPpmCreate , car cela n’aurait aucun effet sur l’objet PPM existant.

L’objet de collection de connecteurs est parenté avec WDFOBJECT même lorsque UcmUcsiConnectorCollectionCreate est appelé en passant WDF_NO_ATTRIBUTES. La durée de vie de l’objet est managée par l’infrastructure.

Configuration requise

Condition requise Valeur
Version KMDF minimale 1,27 %
Version UMDF minimale N/A
En-tête ucmucsippm.h (inclure UcmUcsiCx.h)
Bibliothèque UcmUcsiCxStub.lib
IRQL PASSIVE_LEVEL

Voir aussi

WdfDeviceCreate

WDF_OBJECT_ATTRIBUTES

UcmUcsiPpmCreate

UcmUcsiConnectorCollectionAddConnector