portcls.h 헤더

이 헤더는 오디오에서 사용됩니다. 자세한 내용은 다음을 참조하세요.

• 오디오

portcls.h에는 다음과 같은 프로그래밍 인터페이스가 포함되어 있습니다.

인터페이스

IAdapterPnpManagement IAdapterPnpManagement는 어댑터가 PnP 관리 메시지를 수신하려는 경우 구현하고 등록해야 하는 인터페이스입니다.
IAdapterPowerManagement IAdapterPowerManagement 인터페이스는 오디오 어댑터의 전원 상태를 관리하는 데 사용됩니다.
IAdapterPowerManagement2 IAdapterPowerManagement2 인터페이스는 IUnknown에서 상속되며 오디오 어댑터의 전원 상태를 관리하는 데 사용됩니다.
IAdapterPowerManagement3 IAdapterPowerManagement3 인터페이스는 IUnknown에서 상속되며 전원 관리 메시지를 받는 데 사용됩니다.
IDmaChannel IDmaChannel 인터페이스는 DMA 채널과 관련 DMA 버퍼 및 사용 매개 변수의 추상화 기능을 제공합니다.
IDmaChannelSlave IDmaChannelSlave 인터페이스는 어댑터 개체 소개에 설명된 대로 하위 디바이스에 대한 DMA 채널을 모니터링하고 제어하는 메서드를 제공합니다.
IDrmPort IDrmPort 인터페이스는 WaveCyclic 또는 WavePci 미니포트 드라이버에서 DRM으로 보호되는 콘텐츠를 관리하는 데 사용됩니다(디지털 권한 관리 참조).
IDrmPort2 IDrmPort2 인터페이스는 WaveCyclic 또는 WavePci 미니포트 드라이버에서 DRM으로 보호되는 콘텐츠를 관리하는 데 사용됩니다(디지털 권한 관리 참조).
IInterruptSync IInterruptSync 인터페이스는 ISR(인터럽트 서비스 루틴) 목록의 실행을 ISR이 아닌 루틴과 동기화하는 인터럽트 동기화 개체를 나타냅니다.
IMiniport IMiniport 인터페이스는 모든 미니포트 개체가 지원하는 일반 미니포트 인터페이스입니다. IMiniport는 IUnknown 인터페이스에서 상속됩니다.
IMiniportAudioEngineNode 이 인터페이스를 사용하면 미니포트 드라이버가 KS 필터 핸들을 통해 오디오 엔진에 액세스하는 KS 속성을 사용할 수 있습니다.
IMiniportAudioSignalProcessing IMiniportAudioSignalProcessing 인터페이스는 모든 오디오 드라이버의 WaveRT 미니포트 구성 요소에 의해 구현됩니다( 핀 중 하나라도 오디오 신호 처리 모드를 지원하는 경우).
IMiniportMidi IMiniportMidi 인터페이스는 MIDI 신시사이저 디바이스에 대한 MIDI 미니포트 드라이버의 기본 인터페이스입니다.
IMiniportMidiStream IMiniportMidiStream 인터페이스는 MIDI 필터의 핀을 통해 흐르는 MIDI 스트림을 나타냅니다.
IMiniportPnpNotify IMiniportPnpNotify는 미니포트 개체(오디오 하위 서비스)가 PnP 상태 변경 알림을 받을 수 있도록 하는 선택적 인터페이스입니다.
IMiniportStreamAudioEngineNode 이 인터페이스를 사용하면 미니포트 드라이버가 핀 instance 핸들을 통해 오디오 엔진에 액세스하는 KS 속성을 사용할 수 있습니다.
IMiniportStreamAudioEngineNode2 IMiniportStreamAudioEngineNode2 인터페이스를 사용하면 오디오 미니포트 드라이버가 IMiniportStreamAudioEngineNode 인터페이스의 기능을 확장할 수 있습니다.
IMiniportTopology IMiniportTopology 인터페이스는 토폴로지 미니포트 드라이버의 기본 인터페이스입니다.
IMiniportWaveCyclic IMiniportWaveCyclic 인터페이스는 WaveCyclic 오디오 디바이스에 대한 미니포트 드라이버에 의해 노출되는 기본 인터페이스입니다.
IMiniportWaveCyclicStream IMiniportWaveCyclicStream 인터페이스는 WaveCyclic 필터의 핀을 통해 흐르는 웨이브 스트림을 나타냅니다.
IMiniportWavePci IMiniportWavePci 인터페이스는 WavePci 오디오 디바이스에 대한 미니포트 드라이버에 의해 노출되는 기본 인터페이스입니다.
IMiniportWavePciStream IMiniportWavePciStream 인터페이스는 WavePci 필터의 핀을 통해 흐르는 웨이브 스트림을 나타냅니다.
IMiniportWaveRT IMiniportWaveRT 인터페이스는 WaveRT 오디오 디바이스에 대한 미니포트 드라이버에 의해 노출되는 기본 인터페이스입니다.
IMiniportWaveRTInputStream IMiniportWaveRTInputStream 인터페이스는 WaveRT 렌더링 또는 캡처 디바이스를 래핑하는 KS 필터의 핀을 통해 흐르는 입력 웨이브 스트림을 나타냅니다. IMiniportWaveRTInputStream은 IUnknown 인터페이스에서 상속됩니다.
IMiniportWaveRTOutputStream IMiniportWaveRTOutputStream 인터페이스는 출력 웨이브 스트림을 나타냅니다. IMiniportWaveRTOutputStream은 IUnknown 인터페이스에서 상속됩니다.
IMiniportWaveRTStream IMiniportWaveRTStream 인터페이스는 WaveRT 렌더링 또는 캡처 디바이스를 래핑하는 KS 필터의 핀을 통해 흐르는 웨이브 스트림을 나타냅니다.
IMiniportWaveRTStreamNotification IMiniportWaveRTStreamNotification 인터페이스는 Windows Vista 이상 Windows 운영 체제에서 지원되며 IMiniportWaveRTStream 인터페이스를 보강하여 DMA 드라이버 이벤트 알림을 용이하게 하는 추가 메서드를 제공합니다.
IMusicTechnology IMusicTechnology 인터페이스는 MIDI 또는 DMus 미니포트 드라이버에 속하는 핀의 데이터 범위 설명자에 지정된 음악 기술 GUID를 변경하는 데 사용됩니다.
IPinCount IPinCount 인터페이스는 핀이 인스턴스화되고 닫히면 미니포트 드라이버가 핀 수를 동적으로 모니터링하고 조작할 수 있는 수단을 제공합니다.
IPinName Windows 7 이상 운영 체제에서 IPinName 인터페이스는 미니포트 드라이버에서 오디오 엔드포인트의 이름을 보고하고 업데이트하는 데 사용됩니다.
IPort IPort 인터페이스는 오디오 포트 드라이버에 대한 일반 인터페이스입니다. 모든 오디오 포트 드라이버는 IPort를 아래쪽 가장자리의 일부로 노출합니다. 어댑터 드라이버는 이 인터페이스에서 초기화 메서드를 호출합니다. IPort는 IUnknown 인터페이스에서 상속됩니다.
IPortClsEtwHelper IPortClsEtwHelper 인터페이스를 사용하면 오디오 미니포트 드라이버가 ETW(Windows용 이벤트 추적) 도우미 함수에 액세스할 수 있습니다.
IPortClsNotifications 오디오 모듈 통신을 지원하기 위해 미니포트에 알림 도우미를 제공하기 위해 포트에서 구현하는 인터페이스입니다.
IPortClsPnp IPortClsPnp는 포트 클래스 드라이버(PortCls)가 어댑터에 노출하는 PnP 관리 인터페이스입니다.
IPortClsPower IPortClsPower 인터페이스는 Windows Vista 이상 버전의 Windows에서 지원됩니다. IPortClsPower는 포트 클래스 드라이버(PortCls)가 어댑터에 노출하는 전원 관리 인터페이스입니다.
IPortClsRuntimePower IPortClsRuntimePower는 포트 클래스 드라이버(PortCls)가 오디오 어댑터의 런타임 전원 관리 기능에 액세스하는 데 사용하는 인터페이스입니다.
IPortClsStreamResourceManager IPortClsStreamResourceManager는 오디오 스트림 리소스의 등록을 관리하는 데 사용됩니다.
IPortClsStreamResourceManager2 IPortClsStreamResourceManager2는 오디오 스트림 리소스 등록을 관리하는 데 사용됩니다.
IPortClsVersion IPortClsVersion 인터페이스는 미니포트 드라이버에서 드라이버가 실행 중인 Windows 운영 체제의 버전을 식별하는 데 사용됩니다. 포트 드라이버는 이 인터페이스를 구현하고 미니포트 드라이버에 노출합니다.
IPortEvents IPortEvents 인터페이스는 미니포트 드라이버에서 클라이언트에 하드웨어 이벤트를 알리는 데 사용됩니다.
IPortMidi IPortMidi 인터페이스는 MIDI 포트 드라이버의 기본 인터페이스입니다.
IPortTopology IPortTopology 인터페이스는 토폴로지 미니포트 드라이버에 대한 일반 포트 드라이버 지원을 제공합니다.
IPortWaveCyclic IPortWaveCyclic 인터페이스는 WaveCyclic 포트 드라이버의 기본 인터페이스입니다.
IPortWavePci IPortWavePci 인터페이스는 WavePci 포트 드라이버의 기본 인터페이스입니다.
IPortWavePciStream IPortWavePciStream 인터페이스는 WavePci 미니포트 스트림 개체에 매핑 서비스를 제공하는 스트림 관련 콜백 인터페이스입니다.
IPortWaveRT IPortWaveRT 인터페이스는 Windows Vista 이상 운영 체제에서 지원되며 WaveRT 포트 드라이버가 WaveRT 미니포트 드라이버 개체를 구현하는 어댑터 드라이버에 노출하는 기본 인터페이스입니다.
IPortWaveRTStream IPortWaveRTStream 인터페이스는 Windows Vista 이상 운영 체제에서 지원되며 WaveRT 미니포트 드라이버에서 사용할 도우미 메서드를 제공하는 스트림별 인터페이스입니다.
IPortWMIRegistration IPortWMIRegistration 인터페이스는 Windows 7 이상 버전의 Windows에서 제공됩니다. 이 인터페이스를 사용하면 미니포트 드라이버가 PortCls와 미니포트 드라이버 간에 ETW(Windows용 이벤트 추적) 등록을 조정할 수 있습니다.
IPowerNotify IPowerNotify 인터페이스는 임박한 전원 상태 변경에 대한 사전 알림이 필요한 경우 드라이버가 노출할 수 있는 선택적 인터페이스입니다.
IPreFetchOffset IPreFetchOffset 인터페이스는 DirectSound 출력 스트림에서 재생 및 쓰기 커서를 구분하는 바이트 수인 프리페치 오프셋을 제어합니다.
IRegistryKey IRegistryKey 인터페이스는 미니포트 드라이버가 키와 해당 하위 키에 액세스하는 데 사용할 수 있는 레지스트리 키의 추상화 기능을 제공합니다.
IResourceList IResourceList 인터페이스는 플러그 앤 플레이 관리자가 시작 시 디바이스에 할당하는 시스템 하드웨어 리소스 목록인 구성 리소스 목록의 추상화 기능을 제공합니다.
IServiceGroup IServiceGroup 인터페이스는 모두 동일한 서비스 요청에 대한 알림이 필요한 개체 그룹을 캡슐화합니다.
IServiceSink IServiceSink 인터페이스는 서비스 요청의 처리를 캡슐화합니다.
IUnregisterPhysicalConnection IUnregisterPhysicalConnection 인터페이스는 등록된 물리적 연결을 제거하는 세 가지 메서드를 구현합니다.
IUnregisterSubdevice IUnregisterSubdevice 인터페이스는 등록된 하위 서비스를 제거하는 메서드를 구현합니다.

함수

PcAddAdapterDevice PcAddAdapterDevice 함수는 어댑터 디바이스를 WDM 디바이스 스택에 추가합니다.
PcAddContentHandlers PcAddContentHandlers 함수는 시스템에 보호된 콘텐츠를 처리하는 함수 목록을 제공합니다.
PcAddStreamResource PcAddStreamResource는 스트림 리소스를 추가합니다.
PcCompleteIrp PcCompleteIrp 함수는 이전에 보류 중으로 표시된 IRP를 완료합니다.
PcCompletePendingPropertyRequest 보류 중인 속성 요청을 완료하기 위해 PcCompletePendingPropertyRequest 함수가 호출됩니다.
PcCreateContentMixed PcCreateContentMixed 함수는 일부 KS 오디오 스트림의 혼합 콘텐츠를 포함하는 복합 스트림에 대한 DRM 콘텐츠 권한을 계산합니다.
PcDestroyContent PcDestroyContent 함수는 PcCreateContentMixed에서 만든 DRM 콘텐츠 ID를 삭제합니다. 이 함수 호출은 DrmDestroyContent 함수와 연산에서 동일하며 해당 매개 변수 정의 및 반환 값도 동일합니다.
PcDispatchIrp PcDispatchIrp 함수는 IRP를 PortCls 시스템 드라이버의 기본 처리기로 디스패치합니다.
PcForwardContentToDeviceObject PcForwardContentToDeviceObject 함수는 호출자가 보호된 콘텐츠를 전달하려는 디바이스를 나타내는 디바이스 개체를 허용합니다.
PcForwardContentToFileObject PcForwardContentToFileObject 함수는 사용되지 않으며 기존 드라이버를 지원하기 위해서만 유지 관리됩니다.
PcForwardContentToInterface PcForwardContentToInterface 함수는 호출자가 보호된 콘텐츠를 전달하려는 개체의 COM 인터페이스에 대한 포인터를 허용합니다.
PcForwardIrpSynchronous PcForwardIrpSynchronous 함수는 IRP 처리기에서 플러그 앤 플레이 IRP를 PDO(물리적 디바이스 개체)로 전달하는 데 사용됩니다.
PcGetContentRights PcGetContentRights 함수는 DRM 콘텐츠 ID에 할당된 DRM 콘텐츠 권한을 검색합니다. 이 함수 호출은 DrmGetContentRights 함수와 연산에서 동일하며 해당 매개 변수 정의 및 반환 값도 동일합니다.
PcGetDeviceProperty PcGetDeviceProperty 함수는 레지스트리에서 요청된 디바이스 속성을 반환합니다.
PcGetPhysicalDeviceObject PcGetPhysicalDeviceObject 함수를 사용하면 오디오 미니포트 드라이버가 오디오 디바이스의 기본 물리적 디바이스 개체를 검색할 수 있습니다.
PcGetTimeInterval PcGetTimeInterval 함수는 지정된 시간 이후 경과된 시간을 반환합니다. 시간은 100나노초 단위로 측정됩니다.
PcInitializeAdapterDriver PcInitializeAdapterDriver 함수는 어댑터 드라이버를 PortCls 시스템 드라이버에 바인딩합니다.
PcNewDmaChannel PcNewDmaChannel 함수는 새 DMA 채널 개체를 만듭니다. 이 함수는 사용되지 않습니다. 자세한 내용은 다음 설명을 참조하세요.
PcNewInterruptSync PcNewInterruptSync 함수는 인터럽트 동기화 개체를 만들고 초기화합니다.
PcNewMiniport PcNewMiniport 함수는 portcls.sys PortCls 시스템 드라이버에 기본 제공되는 시스템 제공 미니포트 드라이버 중 하나의 instance 만듭니다.
PcNewPort PcNewPort 함수는 시스템 제공 포트 드라이버 개체를 새로 만듭니다. 이 개체의 인터페이스(기본 클래스 IPort에서 파생됨)는 클래스 ID로 지정됩니다.
PcNewRegistryKey PcNewRegistryKey 함수는 새 레지스트리 키를 열거나 만들고 키를 나타내는 IRegistryKey 개체를 만듭니다. 호출자는 이 개체를 통해 키에 액세스합니다.
PcNewResourceList PcNewResourceList 함수는 리소스 목록을 만들고 초기화합니다.
PcNewResourceSublist PcNewResourceSublist 함수는 다른 리소스 목록에서 파생된 빈 리소스 목록을 만들고 초기화합니다.
PcNewServiceGroup PcNewServiceGroup 함수는 서비스 그룹을 만들고 초기화합니다.
PcRegisterAdapterPnpManagement PcRegisterAdapterPnpManagement 함수는 어댑터의 PnP 관리 인터페이스를 PortCls 시스템 드라이버에 등록합니다. PnP 리밸런스를 지원하는 데 사용됩니다.
PcRegisterAdapterPowerManagement PcRegisterAdapterPowerManagement 함수는 어댑터의 전원 관리 인터페이스를 PortCls 시스템 드라이버에 등록합니다.
PcRegisterIoTimeout PcRegisterIoTimeout 함수는 지정된 디바이스 개체에 대해 드라이버 제공 I/O 타이머 콜백 루틴을 등록합니다.
PcRegisterPhysicalConnection PcRegisterPhysicalConnection 함수는 동일한 어댑터 드라이버에 의해 인스턴스화된 두 오디오 어댑터 필터 간의 물리적 연결을 등록합니다.
PcRegisterPhysicalConnectionFromExternal PcRegisterPhysicalConnectionFromExternal 함수는 외부 오디오 어댑터 필터에서 오디오 어댑터 필터에 대한 물리적 연결을 등록합니다.
PcRegisterPhysicalConnectionToExternal PcRegisterPhysicalConnectionToExternal 함수는 오디오 어댑터 필터에서 외부 오디오 어댑터 필터로의 물리적 연결을 등록합니다.
PcRegisterSubdevice PcRegisterSubdevice 함수는 하위 서비스를 등록하여 클라이언트에서 사용할 수 있도록 합니다.
PcRemoveStreamResource PcRemoveStreamResource는 기존 스트림 리소스를 제거합니다.
PcRequestNewPowerState PcRequestNewPowerState 함수는 디바이스에 대한 새 전원 상태를 요청하는 데 사용됩니다. 이 함수는 일반적으로 어댑터 드라이버에서 필요하지 않지만 일부 종류의 하드웨어 문제를 해결하는 데 유용할 수 있습니다.
PcUnregisterAdapterPnpManagement PcUnregisterAdapterPnpManagement 함수는 PortCls 클래스 드라이버에서 오디오 어댑터의 PnP 관리 인터페이스를 등록 취소합니다. PnP 리밸런스를 지원하는 데 사용됩니다.
PcUnregisterAdapterPowerManagement PcUnregisterAdapterPowerManagement 함수는 PortCls 클래스 드라이버에서 오디오 어댑터의 전원 관리 인터페이스의 등록을 취소합니다. PcUnregisterAdapterPowerManagement 함수는 Windows 7 이상 버전의 Windows에서 사용할 수 있습니다.
PcUnregisterIoTimeout PcUnregisterIoTimeout 함수는 지정된 디바이스 개체에 대해 드라이버 제공 I/O 타이머 콜백 루틴의 등록을 취소합니다.

콜백 함수

PCPFNEVENT_HANDLER EventHandler 루틴은 이벤트 요청을 처리합니다.

구조체

PCAUTOMATION_TABLE PCAUTOMATION_TABLE 구조에는 속성, 메서드 및 이벤트의 미니포트 드라이버 master 테이블이 포함되어 있습니다.
PCEVENT_ITEM PCEVENT_ITEM 구조는 특정 필터, 핀 또는 노드에서 지원하는 이벤트를 설명하는 데 사용됩니다.
PCEVENT_REQUEST PCEVENT_REQUEST 구조는 이벤트 요청을 지정합니다.
PCFILTER_DESCRIPTOR PCFILTER_DESCRIPTOR 구조는 미니포트 드라이버의 필터 구현을 설명합니다. 구조체는 필터의 핀, 노드, 연결 및 속성을 지정합니다.
PCMETHOD_ITEM PCMETHOD_ITEM 구조는 필터, 핀 또는 노드에서 지원하는 메서드를 설명합니다.
PCMETHOD_REQUEST PCMETHOD_REQUEST 구조체는 메서드 요청을 지정합니다.
PCNODE_DESCRIPTOR PCNODE_DESCRIPTOR 구조는 토폴로지 미니포트 드라이버가 구현하는 필터의 노드를 설명합니다.
PCNOTIFICATION_BUFFER IPortClsNotifications에서 사용하는 알림 버퍼입니다.
PCPIN_DESCRIPTOR PCPIN_DESCRIPTOR 구조는 핀 팩터리를 설명합니다.
PCPROPERTY_ITEM PCPROPERTY_ITEM 구조체는 특정 필터, 핀 또는 노드에서 지원하는 속성을 설명합니다.
PCPROPERTY_REQUEST PCPROPERTY_REQUEST 구조체는 속성 요청을 지정합니다.
PCSTREAMRESOURCE_DESCRIPTOR PCSTREAMRESOURCE_DESCRIPTOR 스트림 리소스를 정의합니다. PCSTREAMRESOURCE_DESCRIPTOR_INIT 사용하여 이 구조를 올바르게 초기화합니다.

열거형

eChannelTargetType eChannelTargetType 열거형은 지정된 채널에서 노드 유형(대상)을 지정하는 상수를 정의합니다.
eEngineFormatType eEngineFormatType 열거형은 오디오 엔진에서 지원하는 오디오 데이터 형식을 지정하는 상수를 정의합니다.
EPcMiniportEngineEvent 이 항목에서는 EPcMiniportEngineEvent 열거형을 소개하고 미니포트 드라이버가 결함 오류를 보고할 때 추가 정보를 제공하는 매개 변수에 대해 설명합니다.
PC_EXIT_LATENCY 이 항목에서는 PC_EXIT_LATENCY 열거형에 대해 설명하고 해당 멤버에 대해 설명합니다. 대기 시간은 디바이스가 절전 상태를 종료하고 완전 기능 상태(D0)를 입력할 수 있어야 하는 특정 최대 시간에 매핑됩니다.
PC_REBALANCE_TYPE PC_REBALANCE_TYPE 열거형은 리밸런싱에 대한 지원 유형을 설명합니다.
PcStreamResourceType 이 항목에서는 PcStreamResourceType 열거형에 대해 설명하고 해당 멤버에 대해 설명합니다. PcStreamResourceType 열거형은 특정 오디오 스트리밍에 사용되는 리소스 유형을 정의하는 데 사용됩니다.