다음을 통해 공유

UcmTcpciDeviceInitialize 함수(ucmtcpcidevice.h)

  • 아티클

USB Type-C 포트 컨트롤러 인터페이스 프레임워크 확장(UcmTcpciCx)을 초기화합니다.

구문

NTSTATUS UcmTcpciDeviceInitialize(
  WDFDEVICE               WdfDevice,
  PUCMTCPCI_DEVICE_CONFIG Config
);

매개 변수

WdfDevice

클라이언트 드라이버가 WdfDeviceCreate에 대한 이전 호출에서 받은 프레임워크 디바이스 개체에 대한 핸들입니다.

Config

UCMTCPCI_DEVICE_CONFIG_INIT 호출하여 초기화되는 호출자 제공 UCMTCPCI_DEVICE_CONFIG 구조체에 대한 포인터입니다. 이 값은 NULL일 수 없습니다.

반환 값

(NTSTATUS) 메서드는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드가 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.

반환 코드 설명
STATUS_INFO_LENGTH_MISMATCH
 구성이 가리키는 구조체의 크기가 잘못되었습니다. UCMTCPCI_DEVICE_CONFIG 크기여야 합니다.
STATUS_INVALID_DEVICE_STATE
 프레임워크 디바이스 개체의 플러그 앤 플레이 상태는 초기화되지 않습니다. 드라이버의 EVT_WDF_DRIVER_DEVICE_ADD 구현 내에서 UcmTcpciDeviceInitialize를 호출합니다.

설명

클라이언트 드라이버는 드라이버의 EVT_WDF_DRIVER_DEVICE_ADD 구현 내에서 UcmTcpciDeviceInitialize를 호출해야 합니다. 이 메서드는 프레임워크 디바이스 개체를 구성하고 필요한 리소스를 할당하고, PnP 이벤트를 등록하고, I/O 대상을 설정합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10
지원되는 최소 서버 Windows Server 2016
대상 플랫폼 Windows
헤더 ucmtcpcidevice.h
라이브러리 Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

추가 정보

WdfDeviceCreate