UcmUcsiConnectorCollectionCreate 函式 (ucmucsippm.h)

發行項
02/27/2024

使用UcmUcsiCx建立連接器集合物件。

語法

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

參數

[in] WdfDevice

用戶端驅動程式在先前呼叫 WdfDeviceCreate 中所收到的架構裝置物件的句柄。

[in] Attributes

呼叫端提供的 WDF_OBJECT_ATTRIBUTES 結構的指標，其中包含新連接器集合對象的屬性。這個參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。

[out] ConnectorCollection

接收新連接器集合物件句柄之位置的指標。

傳回值

如果作業成功，則傳回STATUS_SUCCESS。否則，這個方法可以傳回適當的 NTSTATUS 值。

備註

建立平台原則管理員 (PPM) 物件時，需要集合物件。用戶端驅動程式會呼叫 UcmUcsiPpmCreate來建立物件。驅動程式不得在 UcmUcsiPpmCreate 之後呼叫 [UcmUcsiConnectorCollectionCreate]，因為它不會影響已經存在的 PPM 物件。

即使透過傳遞WDF_NO_ATTRIBUTES呼叫UcmUcsiConnectorCollectionCreate，連接器集合物件仍會父代至WDFOBJECT。物件的存留期是由架構所管理。