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 の関連付けを作成します。

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

要件