PcRegisterSubdevice 함수(portcls.h)

PcRegisterSubdevice 함수는 하위 서비스를 등록하여 클라이언트에서 사용할 수 있도록 합니다.

구문

PORTCLASSAPI NTSTATUS PcRegisterSubdevice(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PWSTR          Name,
  [in] PUNKNOWN       Unknown
);

매개 변수

[in] DeviceObject

어댑터 드라이버의 디바이스 개체에 대한 포인터입니다. DEVICE_OBJECT 형식의 시스템 구조입니다.

[in] Name

하위 서비스의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. Name 매개 변수가 가리키는 문자열 버퍼는 디바이스 개체의 수명 동안 유효한 상태를 유지해야 합니다. 문자열에는 하위 서비스를 동일한 디바이스에 등록된 다른 하위 서비스와 구분하는 짧은 이름이 포함되어 있습니다. 각 디바이스의 하위 서비스에는 고유한 이름이 있어야 합니다.

[in] Unknown

하위 서비스에 바인딩된 포트 드라이버 개체의 IPort 인터페이스에 대한 포인터입니다.

반환 값

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

설명

함수는 오디오 어댑터의 하위 서비스를 나타내는 필터 개체에 대한 디바이스 인터페이스 instance 등록합니다. I/O 관리자는 Name 매개 변수로 지정된 문자열을 instance 식별하는 데 사용하는 참조 문자열에 추가합니다. 수정된 참조 문자열은 오디오 어댑터의 하위 서비스를 구분하는 데 유용합니다. 참조 문자열에 대한 자세한 내용은 IoRegisterDeviceInterface를 참조하세요.

하위 서비스를 등록할 때 PcRegisterSubdevice 함수의 역할에 대한 자세한 내용은 하위 서비스 만들기를 참조하세요.

어댑터 드라이버는 IUnregisterSubdevice::UnregisterSubdevice 메서드를 호출하여 PcRegisterSubdevice에 대한 이전 호출로 등록된 실제 연결의 등록을 삭제할 수 있습니다. 자세한 내용은 동적 오디오 하위 서비스를 참조하세요.

요구 사항

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

추가 정보

DEVICE_OBJECT

IPort

IUnregisterSubdevice::UnregisterSubdevice

IoRegisterDeviceInterface