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 結構的指標,該結構是藉由呼叫 UCMUCSI_PPM_CONFIG_INIT初始化。 ConnectorCollectionHandle 成員必須設定為先前呼叫 UcmUcsiConnectorCollectionCreate 中所擷取的句柄。
[in] Attributes
呼叫端提供的 WDF_OBJECT_ATTRIBUTES 結構的指標,其中包含新連接器集合對象的屬性。 這個參數是選擇性的,而且可以WDF_NO_OBJECT_ATTRIBUTES。
[out] PPMObject
接收新 PPM 物件句柄之位置的指標。
傳回值
如果作業成功,則傳回STATUS_SUCCESS。 否則,這個方法可以傳回適當的 NTSTATUS 值。
備註
用戶端驅動程序應該從EVT_WDF_DEVICE_PREPARE_HARDWARE回呼函式呼叫UcmUcsiPpmCreate。
在 Config 中傳遞的結構包含使用 USB Type-C 連接器類別擴充功能建立連接器所需的 Type-C 連接器資訊, (UcmCx) 使用 UcmConnectorCreate ,而且無法透過 UCSI 命令從 PPM 取得,例如 GetCapability 或 GetConnectorCapability。
Config 結構也包含連接器標識碼,這是 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 |