portcls.h 標頭

音訊會使用此標頭。 如需詳細資訊，請參閱

• 音訊

portcls.h 包含下列程式設計介面：

介面

IAdapterPnpManagement IAdapterPnpManagement 是介面卡應該實作並註冊的介面，如果想要接收 PnP 管理訊息。
IAdapterPowerManagement IAdapterPowerManagement 介面是用來管理音訊配接器的電源狀態。
IAdapterPowerManagement2 IAdapterPowerManagement2 介面繼承自 IUnknown，用來管理音訊配接器的電源狀態。
IAdapterPowerManagement3 IAdapterPowerManagement3 介面繼承自 IUnknown，並用於接收電源管理訊息。
IDmaChannel IDmaChannel 介面提供 DMA 通道及其相關聯 DMA 緩衝區和使用參數的抽象概念。
IDmaChannelSchedulee IDmaChannel一介面提供監視和控制從屬裝置的 DMA 通道的方法 (，如配接器物件簡介) 中所述。
IDrmPort IDrmPort 介面是由 WaveCyclic 或 WavePci 迷你埠驅動程式用來管理受 DRM 保護的內容， (請參閱 Digital Rights Management) 。
IDrmPort2 WaveCyclic 或 WavePci 迷你埠驅動程式會使用 IDrmPort2 介面來管理受 DRM 保護的內容， (請參閱 Digital Rights Management) 。
IInterruptSync IInterruptSync 介面代表中斷同步處理物件，該物件會同步處理與非 ISR 常式 (ISR) 插斷服務常式清單的執行。
IMiniport IMiniport 介面是所有迷你埠物件支援的一般迷你埠介面。 IMiniport 繼承自 IUnknown 介面。
IMiniportAudioEngineNode 此介面可讓迷你埠驅動程式使用 KS 屬性，透過 KS 篩選控制碼存取音訊引擎。
IMiniportAudioSignalProcessing 如果任何音訊驅動程式的 Pin 支援音訊訊號處理模式，IMiniportAudioSignalProcessing 介面是由任何音訊驅動程式的 WaveRT 迷你埠元件所實作。
IMiniportMidi IMiniportMidi 介面是 MIDI 合成器裝置 MIDI 迷你埠驅動程式的主要介面。
IMiniportMidiStream IMiniportMidiStream 介面代表在 MIDI 篩選準則上流經針腳的 MIDI 資料流程。
IMiniportPnpNotify IMiniportPnpNotify 是選擇性介面，可讓迷你埠物件 (音訊子裝置) 接收 PnP 狀態變更通知。
IMiniportStreamAudioEngineNode 此介面可讓迷你埠驅動程式使用 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 介面代表流經 KS 篩選上釘選的波浪串流，該篩選準則會包裝 WaveRT 轉譯或擷取裝置。
IMiniportWaveRTStreamNotification Windows Vista 和更新版本的 Windows 作業系統支援 IMiniportWaveRTStreamNotification 介面，並增強 IMiniportWaveRTStream 介面，並提供其他方法來協助 DMA 驅動程式事件通知。
IMusicTechnology IMusicTechnology 介面可用來變更屬於 MIDI 或 DMus 迷你埠驅動程式之針腳之資料範圍描述元中指定的音樂技術 GUID。
IPinCount IPinCount 介面提供一種方法，讓迷你埠驅動程式在針腳具現化和關閉時動態監視及操作其針腳計數。
IPinName 在 Windows 7 和更新版本的作業系統中，迷你埠驅動程式會使用 IPinName 介面來報告和更新音訊端點的名稱。
IPort IPort 介面是音訊埠驅動程式的一般介面。 所有音訊埠驅動程式都會公開 IPort 作為其下邊緣的一部分。 配接器驅動程式會在此介面上呼叫初始化方法。 IPort 繼承自 IUnknown 介面。
IPortClsEtwHelper IPortClsEtwHelper 介面可讓音訊迷你埠驅動程式存取 Windows 事件追蹤 (ETW) 協助程式函式。
IPortClsNotifications 由埠實作的介面，以提供通知協助程式給迷你埠，以支援音訊模組通訊。
IPortClsPnp IPortClsPnp 是埠類別驅動程式 (PortCls) 公開給介面卡的 PnP 管理介面。
IPortClsPower Windows Vista 和更新版本的 Windows 支援 IPortClsPower 介面。 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 Windows Vista 和更新版本的作業系統支援 IPortWaveRT 介面，而它是 WaveRT 埠驅動程式向實作 WaveRT 迷你埠驅動程式物件的介面卡驅動程式公開的主要介面。
IPortWaveRTStream Windows Vista 和更新版本的作業系統都支援 IPortWaveRTStream 介面，它是一種串流特定介面，可提供 WaveRT 迷你埠驅動程式使用的協助程式方法。
IPortWMIRegistration IPortWMIRegistration 介面是在 Windows 7 和更新版本的 Windows 中提供。 此介面可讓迷你埠驅動程式協調 Windows (ETW 的事件追蹤，) PortCls 與迷你埠驅動程式之間的註冊。
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 函式會計算複合資料流程的 DRM 內容許可權，其中包含來自某些 KS 音訊資料流程的混合內容。
PcDestroyContent PcDestroyContent 函式會刪除 PcCreateContentMixed 所建立的 DRM 內容識別碼。 請注意，此函式呼叫在作業中與 DrmDestroyContent 函式相同，而且其參數定義和傳回值也相同。
PcDispatchIrp PcDispatchIrp 函式會將 IRP 分派至 PortCls 系統驅動程式的預設處理常式。
PcForwardContentToDeviceObject PcForwardContentToDeviceObject 函式接受代表呼叫端想要轉送受保護內容的裝置物件。
PcForwardContentToFileObject PcForwardContentToFileObject 函式已過時，而且只維護以支援現有的驅動程式。
PcForwardContentToInterface PcForwardContentToInterface 函式接受呼叫端想要轉送受保護內容的物件的 COM 介面指標。
PcForwardIrpSynchronous PcForwardIrpSynchronous 函式是由 IRP 處理常式用來將隨插即用 IRP 轉送至實體裝置物件， (PDO) 。
PcGetContentRights PcGetContentRights 函式會擷取指派給 DRM 內容識別碼的 DRM 內容許可權。 請注意，此函式呼叫在作業中與 DrmGetContentRights 函式相同，而且其參數定義和傳回值也相同。
PcGetDeviceProperty PcGetDeviceProperty 函式會從登錄傳回要求的裝置屬性。
PcGetPhysicalDeviceObject PcGetPhysicalDeviceObject 函式可讓音訊迷你埠驅動程式擷取音訊裝置的基礎實體裝置物件。
PcGetTimeInterval PcGetTimeInterval 函式會傳回自指定時間以來經過的時間。 時間是以 100 奈秒為單位來測量。
PcInitializeAdapterDriver PcInitializeAdapterDriver 函式會將介面卡驅動程式系結至 PortCls 系統驅動程式。
PcNewDmaChannel PcNewDmaChannel 函式會建立新的 DMA 通道物件。 此函式已過時;如需詳細資訊，請參閱下列批註。
PcNewInterruptSync PcNewInterruptSync 函式會建立並初始化中斷同步處理物件。
PcNewMiniport PcNewMiniport 函式會建立其中一個系統提供的迷你埠驅動程式實例，這些驅動程式內建于 PortCls 系統驅動程式中，portcls.sys。
PcNewPort PcNewPort 函式會建立新的系統提供的埠驅動程式物件，其介面 (衍生自基類 IPort) 是由類別識別碼所指定。
PcNewRegistryKey PcNewRegistryKey 函式會開啟或建立新的登錄機碼，並建立 IRegistryKey 物件來代表機碼。 呼叫端會透過這個 物件存取金鑰。
PcNewResourceList PcNewResourceList 函式會建立並初始化資源清單。
PcNewResourceSublist PcNewResourceSublist 函式會建立並初始化衍生自另一個資源清單的空白資源清單。
PcNewServiceGroup PcNewServiceGroup 函式會建立並初始化服務群組。
PcRegisterAdapterPnpManagement PcRegisterAdapterPnpManagement 函式會向 PortCls 系統驅動程式註冊介面卡的 PnP 管理介面。 它用來支援 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 結構包含迷你埠驅動程式的屬性、方法和事件主資料表。
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 列舉可用來定義用於特定音訊串流的資源類型。