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 |