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 |