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 に渡される構造体には、UcmConnectorCreate を使用して USB Type-C コネクタ クラス拡張 (UcmCx) を使用してコネクタを作成するために必要な Type-C コネクタ情報が含まれており、GetCapability や GetConnectorCapability などの UCSI コマンドを使用して PPM から取得することはできません。

Config 構造体には、USB Type-C コネクタと USB ポート間の 1 対 1 のマッピングに必要なコネクタ ID も含まれています。

PPM オブジェクトも WDFOBJECT であり、クライアント ドライバーによって提供される WDFDEVICE ハンドルとの 1 対 1 の関連付けを作成します。

WDF_NO_ATTRIBUTESを渡すことによって UcmUcsiPpmCreate が呼び出された場合でも、PPM オブジェクトは WDFOBJECT に親されます。 オブジェクトの有効期間は、フレームワークによるマネージャーです。

必要条件

要件	価値
最小 KMDF バージョン	1.27
UMDF の最小バージョン を する	N/A
ヘッダー	Ucmucsippm.h (UcmUcsiCx.h を含む)
ライブラリ	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL