UcmUcsiPpmCreate 函式 (Ucmucsippm.h)
建立平台原則管理員 (PPM) 物件。
語法
NTSTATUS UcmUcsiPpmCreate(
[in] WDFDEVICE WdfDevice,
[in] PUCMUCSI_PPM_CONFIG Config,
[in] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] UCMUCSIPPM *PPMObject
);
參數
[in] WdfDevice
用戶端驅動程式在上一次呼叫 WdfDeviceCreate中收到的架構裝置物件的句柄。
[in] Config
呼叫 UCMUCSI_PPM_CONFIG_INIT所初始化之呼叫端所提供之 UCMUCSI_PPM_CONFIG 結構的指標。 ConnectorCollectionHandle 成員必須設定為先前呼叫 UcmUcsiConnectorCollectionCreate 中所擷取的句柄。
[in] Attributes
由呼叫端提供之 WDF_OBJECT_ATTRIBUTES 結構的指標,其中包含新連接器集合對象的屬性。 這個參數是選擇性的,而且可以WDF_NO_OBJECT_ATTRIBUTES。
[out] PPMObject
接收新 PPM 物件句柄之位置的指標。
傳回值
如果作業成功,則傳回STATUS_SUCCESS。 否則,此方法可以傳回適當的 NTSTATUS 值。
言論
用戶端驅動程序應該從 EVT_WDF_DEVICE_PREPARE_HARDWARE 回呼函式呼叫 UcmUcsiPpmCreate。
Config 中傳遞的結構包含使用 Type-C UcmConnectorCreate 從 PPM 透過 GetCapability 或 GetConnectorCapability 等 UCSI 命令建立連接器所需的 Type-C 連接器資訊。
組態 結構也包含連接器標識碼,這是USB Type-C 連接器與USB埠之間的一對一對應所需的。
PPM 物件也是 WDFOBJECT,並與客戶端驅動程式所提供的 WDFDEVICE 句柄建立一對一關聯。
即使透過傳遞WDF_NO_ATTRIBUTES呼叫UcmUcsiPpmCreate,PPM物件仍會父系至WDFOBJECT。 物件的存留期是由架構所管理。
要求
要求 | 價值 |
---|---|
最低 KMDF 版本 | 1.27 |
最低 UMDF 版本 | N/A |
標頭 | Ucmucsippm.h (包括 UcmUcsiCx.h) |
連結庫 | UcmUcsiCxStub.lib |
IRQL | PASSIVE_LEVEL |