PcNewPort 함수(portcls.h)

아티클
08/07/2023

PcNewPort 함수는 시스템 제공 포트 드라이버 개체를 새로 만듭니다. 이 개체의 인터페이스(기본 클래스 IPort에서 파생됨)는 클래스 ID로 지정됩니다.

구문

PORTCLASSAPI NTSTATUS PcNewPort(
  [out] PPORT    *OutPort,
  [in]  REFCLSID ClassID
);

매개 변수

[out] OutPort

이 함수에서 만든 포트 드라이버 개체에 대한 출력 포인터입니다. 이 매개 변수는 함수가 새로 만든 IPort 개체에 대한 포인터를 출력하는 호출자 할당 포인터 변수를 가리킵니다. 이 개체에는 ClassId 매개 변수로 지정된 포트 인터페이스가 있습니다. 이 매개 변수에 유효한 NULL이 아닌 포인터 값을 지정합니다.

[in] ClassID

요청되는 포트 인터페이스의 형식을 지정합니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

반환 값

PcNewPort는 호출이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

설명

ClassId 매개 변수는 다음 표의 GUID 중 하나로 설정할 수 있습니다.

클래스 GUID	포트 인터페이스 이름
CLSID_PortDMus	IPortDMus
CLSID_PortMidi	IPortMidi
CLSID_PortTopology	IPortTopology
CLSID_PortWaveCyclic	IPortWaveCyclic
CLSID_PortWavePci	IPortWavePci
CLSID_PortWaveRT	IPortWaveRT

CLSID_PortDMus 헤더 파일 dmusicks.h에 정의되어 있습니다. 앞의 표에 있는 다른 4개의 GUID는 portcls.h에 정의되어 있습니다.

Microsoft Windows XP 이상에서는 MIDI 및 DirectMusic 포트 드라이버가 동일한 내부 소프트웨어 구현을 공유합니다. 즉 , CLSID_PortMidi GUID는 CLSID_PortDMus 동일합니다.

하위 서비스에 대한 포트 및 미니포트 드라이버를 만드는 방법에 대한 자세한 내용은 하위 서비스 만들기를 참조하세요.

OutPort 매개 변수는 COM 개체에 대한 참조 계산 규칙을 따릅니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	PortCls 시스템 드라이버는 Microsoft Windows 98/Me 및 Windows 2000 이상 운영 체제에서 PcNewPort 함수를 구현합니다.
대상 플랫폼	유니버설
헤더	portcls.h(Portcls.h 포함)
라이브러리	Portcls.lib
IRQL	PASSIVE_LEVEL