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 例程的執行。
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 介面代表在包裝 WaveRT 轉譯或擷取裝置的 KS 篩選器上流經針腳的波浪串流。
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 中提供。此介面可讓迷你埠驅動程序協調 PortCls 與迷你埠驅動程式之間的 Windows 事件追蹤（ETW）註冊。
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 列舉可用來定義用於特定音訊串流的資源類型。

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-04-09

共用方式為

portcls.h 標頭

介面

功能

回呼函式

結構

列舉

意見反應

其他資源