UcmUcsiConnectorCollectionCreate 関数 (ucmucsippm.h)

  • [アーティクル]

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 オブジェクトには影響しないためです。

UcmUcsiConnectorCollectionCreate が WDF_NO_ATTRIBUTES渡されて呼び出された場合でも、コネクタ コレクション オブジェクトは WDFOBJECT に親されます。 オブジェクトの有効期間は、フレームワークによるマネージャーです。

要件

要件 値
最小 KMDF バージョン 1.27
最小 UMDF バージョン 該当なし
Header ucmucsippm.h (UcmUcsiCx.h を含む)
Library UcmUcsiCxStub.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

WdfDeviceCreate

WDF_OBJECT_ATTRIBUTES

UcmUcsiPpmCreate

UcmUcsiConnectorCollectionAddConnector