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에서 가져올 수 없습니다.

구성 구조에는 USB Type-C 커넥터와 USB 포트 간의 일대일 매핑에 필요한 커넥터 ID도 포함되어 있습니다.

PPM 개체는 WDFOBJECT이기도 하며 클라이언트 드라이버에서 제공하는 WDFDEVICE 핸들과 일대일 연결을 만듭니다.

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

요구 사항