Funzione UcmUcsiConnectorCollectionCreate (ucmucsippm.h)

  • Articolo

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

Vedi anche

WdfDeviceCreate

WDF_OBJECT_ATTRIBUTES

UcmUcsiPpmCreate

UcmUcsiConnectorCollectionAddConnector