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를 호출하여 개체를 만듭니다. 드라이버는 기존 PPM 개체에 영향을 주지 않으므로 UcmUcsiPpmCreate 후에 [UcmUcsiConnectorCollectionCreate]를 호출하면 안 됩니다.

UcmUcsiConnectorCollectionCreate가 WDF_NO_ATTRIBUTES 전달하여 호출되는 경우에도 커넥터 컬렉션 개체는 WDFOBJECT에 부모로 지정됩니다. 개체의 수명은 프레임워크의 관리자입니다.

요구 사항

요구 사항	값
최소 KMDF 버전	1.27
최소 UMDF 버전	해당 없음
머리글	ucmucsippm.h(UcmUcsiCx.h 포함)
라이브러리	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL

추가 정보

WdfDeviceCreate

WDF_OBJECT_ATTRIBUTES

UcmUcsiPpm만들기

UcmUcsiConnectorCollectionAddConnector