Funzione UcmUcsiConnectorCollectionCreate (ucmucsippm.h)
Crea un oggetto raccolta connettore con UcmUcsiCx.
Sintassi
NTSTATUS UcmUcsiConnectorCollectionCreate(
[in] WDFDEVICE WdfDevice,
[in] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] UCMUCSI_CONNECTOR_COLLECTION *ConnectorCollection
);
Parametri
[in] WdfDevice
Handle per un oggetto dispositivo framework ricevuto dal driver client nella chiamata precedente a WdfDeviceCreate.
[in] Attributes
Puntatore a una struttura di WDF_OBJECT_ATTRIBUTES fornita dal chiamante che contiene attributi per il nuovo oggetto raccolta connettori. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.
[out] ConnectorCollection
Puntatore a una posizione che riceve un handle per il nuovo oggetto raccolta connettore.
Valore restituito
Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo può restituire un valore NTSTATUS appropriato.
Commenti
L'oggetto raccolta è necessario per la creazione di un oggetto Platform Policy Manager (PPM). Il driver client crea l'oggetto chiamando UcmUcsiPpmCreate. Il driver non deve chiamare [UcmUcsiConnectorCollectionCreate] dopo UcmUcsiPpmCreate perché non avrà alcun effetto sull'oggetto PPM già esistente.
L'oggetto raccolta connettore è padre di WDFOBJECT anche quando UcmUcsiConnectorCollectionCreate viene chiamato passando WDF_NO_ATTRIBUTES. La durata dell'oggetto è gestita dal framework.
Requisiti
| Requisito | Valore |
|---|---|
| Versione KMDF minima | 1.27 |
| Versione UMDF minima | N/D |
| Intestazione | ucmucsippm.h (include UcmUcsiCx.h) |
| Libreria | UcmUcsiCxStub.lib |
| IRQL | PASSIVE_LEVEL |