PcNewPort 함수(portcls.h)
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 | |
CLSID_PortMidi | |
CLSID_PortTopology | |
CLSID_PortWaveCyclic | |
CLSID_PortWavePci | |
CLSID_PortWaveRT |
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 |