portcls.h-Header

Dieser Header wird vom Audio verwendet. Weitere Informationen finden Sie unter

• Audio

portcls.h enthält die folgenden Programmierschnittstellen:

Schnittstellen

IAdapterPnpManagement IAdapterPnpManagement ist eine Schnittstelle, die Adapter implementieren und registrieren sollten, wenn sie PnP-Verwaltungsnachrichten empfangen möchten.
IAdapterPowerManagement Die IAdapterPowerManagement-Schnittstelle wird verwendet, um den Energiezustand eines Audioadapters zu verwalten.
IAdapterPowerManagement2 Die IAdapterPowerManagement2-Schnittstelle erbt von IUnknown und wird verwendet, um den Energiezustand eines Audioadapters zu verwalten.
IAdapterPowerManagement3 Die IAdapterPowerManagement3-Schnittstelle erbt von IUnknown und wird zum Empfangen von Energieverwaltungsnachrichten verwendet.
IDmaChannel Die IDmaChannel-Schnittstelle bietet eine Abstraktion eines DMA-Kanals und der zugehörigen DMA-Puffer- und Nutzungsparameter.
IDmaChannelSlave Die IDmaChannelSlave-Schnittstelle bietet Methoden zum Überwachen und Steuern eines DMA-Kanals für ein untergeordnetes Gerät (wie unter Einführung in Adapterobjekte beschrieben).
IDrmPort Die IDrmPort-Schnittstelle wird von einem WaveCyclic- oder WavePci-Miniporttreiber verwendet, um DRM-geschützte Inhalte zu verwalten (siehe Digital Rights Management).
IDrmPort2 Die IDrmPort2-Schnittstelle wird von einem WaveCyclic- oder WavePci-Miniporttreiber verwendet, um DRM-geschützte Inhalte zu verwalten (siehe Digital Rights Management).
IInterruptSync Die IInterruptSync-Schnittstelle stellt ein Interruptsynchronisierungsobjekt dar, das die Ausführung einer Liste von Interruptdienstroutinen (ISRs) mit Nicht-ISR-Routinen synchronisiert.
IMiniport Die IMiniport-Schnittstelle ist die generische Miniportschnittstelle, die von allen Miniportobjekten unterstützt wird. IMiniport erbt von der IUnknown-Schnittstelle.
IMiniportAudioEngineNode Diese Schnittstelle ermöglicht es einem Miniporttreiber, KS-Eigenschaften zu verwenden, die über ein KS-Filterhandle auf die Audio-Engine zugreifen.
IMiniportAudioSignalProcessing Die IMiniportAudioSignalProcessing-Schnittstelle wird von der WaveRT-Miniportkomponente eines beliebigen Audiotreibers implementiert, wenn einer seiner Pins Audiosignalverarbeitungsmodi unterstützt.
IMiniportMidi Die IMiniportMidi-Schnittstelle ist die primäre Schnittstelle für einen MIDI-Miniporttreiber für ein MIDI-Synthesizergerät.
IMiniportMidiStream Die IMiniportMidiStream-Schnittstelle stellt den MIDI-Stream dar, der durch einen Pin an einem MIDI-Filter fließt.
IMiniportPnpNotify IMiniportPnpNotify ist eine optionale Schnittstelle, mit der Miniportobjekte (Audiountergeräte) PnP-Zustandsänderungsbenachrichtigungen empfangen können.
IMiniportStreamAudioEngineNode Diese Schnittstelle ermöglicht es einem Miniporttreiber, KS-Eigenschaften zu verwenden, die über einen Pin instance Handle auf die Audio-Engine zugreifen.
IMiniportStreamAudioEngineNode2 Die IMiniportStreamAudioEngineNode2-Schnittstelle ermöglicht es einem Audio-Miniporttreiber, die Funktionen der IMiniportStreamAudioEngineNode-Schnittstelle zu erweitern.
IMiniportTopology Die IMiniportTopology-Schnittstelle ist die primäre Schnittstelle eines Topologie-Miniporttreibers.
IMiniportWaveCyclic Die IMiniportWaveCyclic-Schnittstelle ist die primäre Schnittstelle, die vom Miniporttreiber für ein WaveCyclic-Audiogerät verfügbar gemacht wird.
IMiniportWaveCyclicStream Die IMiniportWaveCyclicStream-Schnittstelle stellt den Wellenstrom dar, der durch einen Pin in einem WaveCyclic-Filter fließt.
IMiniportWavePci Die IMiniportWavePci-Schnittstelle ist die primäre Schnittstelle, die vom Miniporttreiber für ein WavePci-Audiogerät verfügbar gemacht wird.
IMiniportWavePciStream Die IMiniportWavePciStream-Schnittstelle stellt den Wellenstrom dar, der durch einen Pin in einem WavePci-Filter fließt.
IMiniportWaveRT Die IMiniportWaveRT-Schnittstelle ist die primäre Schnittstelle, die vom Miniporttreiber für ein WaveRT-Audiogerät verfügbar gemacht wird.
IMiniportWaveRTInputStream Die IMiniportWaveRTInputStream-Schnittstelle stellt den Eingabewellenstrom dar, der durch einen Pin auf dem KS-Filter fließt, der ein WaveRT-Rendering- oder Erfassungsgerät umschließt. IMiniportWaveRTInputStream erbt von der IUnknown-Schnittstelle.
IMiniportWaveRTOutputStream Die IMiniportWaveRTOutputStream-Schnittstelle stellt den Ausgabewellenstrom dar. IMiniportWaveRTOutputStream erbt von der IUnknown-Schnittstelle.
IMiniportWaveRTStream Die IMiniportWaveRTStream-Schnittstelle stellt den Wellenstrom dar, der durch einen Pin auf dem KS-Filter fließt, der ein WaveRT-Rendering- oder Erfassungsgerät umschließt.
IMiniportWaveRTStreamNotification Die IMiniportWaveRTStreamNotification-Schnittstelle wird in Windows Vista und höheren Windows-Betriebssystemen unterstützt und erweitert die IMiniportWaveRTStream-Schnittstelle und stellt zusätzliche Methoden zur Erleichterung von Ereignisbenachrichtigungen für DMA-Treiber bereit.
IMusicTechnology Die IMusicTechnology-Schnittstelle wird verwendet, um die GUIDs der Musiktechnologie zu ändern, die in den Datenbereichsdeskriptoren für die Pins eines MIDI- oder DMus-Miniporttreibers angegeben sind.
IPinCount Die IPinCount-Schnittstelle bietet dem Miniporttreiber eine Möglichkeit, seine Pinanzahl dynamisch zu überwachen und zu bearbeiten, wenn Pins instanziiert und geschlossen werden.
IPinName Unter Windows 7 und höher wird die IPinName-Schnittstelle von Miniporttreibern verwendet, um die Namen von Audioendpunkten zu melden und zu aktualisieren.
Iport Die IPort-Schnittstelle ist die generische Schnittstelle für Audioporttreiber. Alle Audioporttreiber machen IPort als Teil ihres unteren Rands verfügbar. Der Adaptertreiber ruft die Initialisierungsmethode für diese Schnittstelle auf. IPort erbt von der IUnknown-Schnittstelle.
IPortClsEtwHelper Die IPortClsEtwHelper-Schnittstelle ermöglicht einem Audio-Miniporttreiber den Zugriff auf die EtW-Hilfsfunktionen (Event Tracing for Windows).
IPortClsNotifications Eine von Ports implementierte Schnittstelle, um Benachrichtigungshilfsprogramme für Miniports bereitzustellen, um die Kommunikation von Audiomodulen zu unterstützen.
IPortClsPnp IPortClsPnp ist die PnP-Verwaltungsschnittstelle, die der Portklassentreiber (PortCls) dem Adapter zur Verfügung stellt.
IPortClsPower Die IPortClsPower-Schnittstelle wird in Windows Vista und höheren Versionen von Windows unterstützt. IPortClsPower ist die Energieverwaltungsschnittstelle, die der Portklassentreiber (PortCls) dem Adapter zur Verfügung stellt.
IPortClsRuntimePower IPortClsRuntimePower ist die Schnittstelle, die der Portklassentreiber (PortCls) für den Zugriff auf die Laufzeitleistungsverwaltungsfunktionen des Audioadapters verwendet.
IPortClsStreamResourceManager IPortClsStreamResourceManager wird verwendet, um die Registrierung von Audiostreamressourcen zu verwalten.
IPortClsStreamResourceManager2 IPortClsStreamResourceManager2 wird verwendet, um die Registrierung von Audiostreamressourcen zu verwalten.
IPortClsVersion Die IPortClsVersion-Schnittstelle wird von einem Miniporttreiber verwendet, um die Version des Windows-Betriebssystems zu identifizieren, auf dem der Treiber ausgeführt wird. Der Porttreiber implementiert diese Schnittstelle und macht sie für den Miniporttreiber verfügbar.
IPortEvents Die IPortEvents-Schnittstelle wird von Miniporttreibern verwendet, um Clients über Hardwareereignisse zu benachrichtigen.
IPortMidi Die IPortMidi-Schnittstelle ist die primäre Schnittstelle des MIDI-Porttreibers.
IPortTopology Die IPortTopology-Schnittstelle bietet generische Porttreiberunterstützung für einen Topologie-Miniporttreiber.
IPortWaveCyclic Die IPortWaveCyclic-Schnittstelle ist die primäre Schnittstelle des WaveCyclic-Porttreibers.
IPortWavePci Die IPortWavePci-Schnittstelle ist die primäre Schnittstelle des WavePci-Porttreibers.
IPortWavePciStream Die IPortWavePciStream-Schnittstelle ist die stream-zugeordnete Rückrufschnittstelle, die Zuordnungsdienste für WavePci-Miniportstreamobjekte bereitstellt.
IPortWaveRT Die IPortWaveRT-Schnittstelle wird in Windows Vista und höheren Betriebssystemen unterstützt, und es ist die Standard Schnittstelle, die der WaveRT-Porttreiber dem Adaptertreiber zur Verfügung stellt, der das WaveRT-Miniporttreiberobjekt implementiert.
IPortWaveRTStream Die IPortWaveRTStream-Schnittstelle wird in Windows Vista und höheren Betriebssystemen unterstützt, und es handelt sich um eine streamspezifische Schnittstelle, die Hilfsmethoden für die Verwendung durch den WaveRT-Miniporttreiber bereitstellt.
IPortWMIRegistration Die IPortWMIRegistration-Schnittstelle wird in Windows 7 und höheren Versionen von Windows bereitgestellt. Diese Schnittstelle ermöglicht es dem Miniporttreiber, die ETW-Registrierung (Event Tracing for Windows) zwischen PortCls und dem Miniporttreiber zu koordinieren.
IPowerNotify Die IPowerNotify-Schnittstelle ist eine optionale Schnittstelle, die Miniporttreiber verfügbar machen können, wenn sie eine vorherige Benachrichtigung über bevorstehende Energiezustandsänderungen benötigen.
IPreFetchOffset Die IPreFetchOffset-Schnittstelle steuert den Vorabrufoffset, d. h. die Anzahl der Bytes, die die Wiedergabe- und Schreibcursoren in einem DirectSound-Ausgabestream trennen.
IRegistryKey Die IRegistryKey-Schnittstelle bietet eine Abstraktion eines Registrierungsschlüssels, den ein Miniporttreiber für den Zugriff auf den Schlüssel und seine Unterschlüssel verwenden kann.
IResourceList Die IResourceList-Schnittstelle stellt eine Abstraktion einer Konfigurationsressourcenliste bereit. Dabei handelt es sich um eine Liste der Systemhardwareressourcen, die der Plug-and-Play-Manager einem Gerät zum Startzeitpunkt zuweist.
IServiceGroup Die IServiceGroup-Schnittstelle kapselt eine Gruppe von Objekten, die alle eine Benachrichtigung über dieselbe Dienstanforderung erfordern.
IServiceSink Die IServiceSink-Schnittstelle kapselt die Behandlung einer Dienstanforderung.
IUnregisterPhysicalConnection Die IUnregisterPhysicalConnection-Schnittstelle implementiert drei Methoden zum Entfernen einer registrierten physischen Verbindung.
IUnregisterSubdevice Die IUnregisterSubdevice-Schnittstelle implementiert eine Methode zum Entfernen eines registrierten Untergerätes.

Functions

PcAddAdapterDevice Die PcAddAdapterDevice-Funktion fügt dem WDM-Gerätestapel ein Adaptergerät hinzu.
PcAddContentHandlers Die PcAddContentHandlers-Funktion stellt dem System eine Liste von Funktionen bereit, die geschützte Inhalte verarbeiten.
PcAddStreamResource PcAddStreamResource fügt eine Streamressource hinzu.
PcCompleteIrp Die PcCompleteIrp-Funktion schließt ein IRP ab, das zuvor als ausstehend gekennzeichnet wurde.
PcCompletePendingPropertyRequest Die PcCompletePendingPropertyRequest-Funktion wird aufgerufen, um eine ausstehende Eigenschaftsanforderung abzuschließen.
PcCreateContentMixed Die PcCreateContentMixed-Funktion berechnet die DRM-Inhaltsrechte für einen zusammengesetzten Datenstrom, der gemischte Inhalte aus einer Reihe von KS-Audiostreams enthält.
PcDestroyContent Die PcDestroyContent-Funktion löscht eine DRM-Inhalts-ID, die von PcCreateContentMixed erstellt wurde. Beachten Sie, dass dieser Funktionsaufruf im Betrieb mit der DrmDestroyContent-Funktion identisch ist und die Parameterdefinitionen und der Rückgabewert ebenfalls identisch sind.
PcDispatchIrp Die PcDispatchIrp-Funktion sendet einen IRP an den Standardhandler des PortCls-Systemtreibers.
PcForwardContentToDeviceObject Die PcForwardContentToDeviceObject-Funktion akzeptiert ein Geräteobjekt, das ein Gerät darstellt, an das der Aufrufer geschützte Inhalte weiterleiten möchte.
PcForwardContentToFileObject Die PcForwardContentToFileObject-Funktion ist veraltet und wird nur beibehalten, um vorhandene Treiber zu unterstützen.
PcForwardContentToInterface Die PcForwardContentToInterface-Funktion akzeptiert einen Zeiger auf die COM-Schnittstelle eines Objekts, an das der Aufrufer geschützte Inhalte weiterleiten möchte.
PcForwardIrpSynchronous Die PcForwardIrpSynchronous-Funktion wird von IRP-Handlern verwendet, um Plug-and-Play-IRPs an das physische Geräteobjekt (PDO) weiterzuleiten.
PcGetContentRights Die PcGetContentRights-Funktion ruft die DRM-Inhaltsberechtigungen ab, die einer DRM-Inhalts-ID zugewiesen sind. Beachten Sie, dass dieser Funktionsaufruf im Betrieb mit der DrmGetContentRights-Funktion identisch ist und die Parameterdefinitionen und der Rückgabewert ebenfalls identisch sind.
PcGetDeviceProperty Die PcGetDeviceProperty-Funktion gibt die angeforderte Geräteeigenschaft aus der Registrierung zurück.
PcGetPhysicalDeviceObject Mit der Funktion PcGetPhysicalDeviceObject können Audio-Miniporttreiber das zugrunde liegende physische Geräteobjekt des Audiogeräts abrufen.
PcGetTimeInterval Die PcGetTimeInterval-Funktion gibt die seit einer angegebenen Zeit verstrichene Zeit zurück. Die Zeit wird in 100 Nanosekundeneinheiten gemessen.
PcInitializeAdapterDriver Die PcInitializeAdapterDriver-Funktion bindet einen Adaptertreiber an den PortCls-Systemtreiber.
PcNewDmaChannel Die PcNewDmaChannel-Funktion erstellt ein neues DMA-Kanalobjekt. Diese Funktion ist veraltet. Weitere Informationen finden Sie in den folgenden Kommentaren.
PcNewInterruptSync Die PcNewInterruptSync-Funktion erstellt und initialisiert ein Interruptsynchronisierungsobjekt.
PcNewMiniport Die PcNewMiniport-Funktion erstellt eine instance eines der vom System bereitgestellten Miniporttreiber, die in den PortCls-Systemtreiber integriert sind, portcls.sys.
PcNewPort Die PcNewPort-Funktion erstellt ein neues vom System bereitgestelltes port-driver-Objekt, dessen Schnittstelle (von der Basisklasse IPort abgeleitet) durch eine Klassen-ID angegeben wird.
PcNewRegistryKey Die PcNewRegistryKey-Funktion wird geöffnet oder erstellt einen neuen Registrierungsschlüssel und ein IRegistryKey-Objekt zur Darstellung des Schlüssels. Der Aufrufer greift über dieses Objekt auf den Schlüssel zu.
PcNewResourceList Die PcNewResourceList-Funktion erstellt und initialisiert eine Ressourcenliste.
PcNewResourceSublist Die PcNewResourceSublist-Funktion erstellt und initialisiert eine leere Ressourcenliste, die von einer anderen Ressourcenliste abgeleitet wird.
PcNewServiceGroup Die PcNewServiceGroup-Funktion erstellt und initialisiert eine Dienstgruppe.
PcRegisterAdapterPnpManagement Die Funktion PcRegisterAdapterPnpManagement registriert die PnP-Verwaltungsschnittstelle des Adapters beim PortCls-Systemtreiber. Es wird verwendet, um den PnP-Ausgleich zu unterstützen.
PcRegisterAdapterPowerManagement Die Funktion PcRegisterAdapterPowerManagement registriert die Energieverwaltungsschnittstelle des Adapters beim PortCls-Systemtreiber.
PcRegisterIoTimeout Die PcRegisterIoTimeout-Funktion registriert eine vom Treiber bereitgestellte I/O-Timer-Rückrufroutine für ein angegebenes Geräteobjekt.
PcRegisterPhysicalConnection Die Funktion PcRegisterPhysicalConnection registriert eine physische Verbindung zwischen zwei Audioadapterfiltern, die vom gleichen Adaptertreiber instanziiert werden.
PcRegisterPhysicalConnectionFromExternal Die PcRegisterPhysicalConnectionFromExternal-Funktion registriert eine physische Verbindung mit einem Audioadapterfilter aus einem externen Audioadapterfilter.
PcRegisterPhysicalConnectionToExternal Die PcRegisterPhysicalConnectionToExternal-Funktion registriert eine physische Verbindung von einem Audioadapterfilter mit einem externen Audioadapterfilter.
PcRegisterSubdevice Die PcRegisterSubdevice-Funktion registriert ein Untergerät, um es für die Verwendung durch Clients verfügbar zu machen.
PcRemoveStreamResource PcRemoveStreamResource entfernt eine vorhandene Streamressource.
PcRequestNewPowerState Die PcRequestNewPowerState-Funktion wird verwendet, um einen neuen Energiezustand für das Gerät anzufordern. Diese Funktion wird in der Regel von Adaptertreibern nicht benötigt, kann aber gelegentlich hilfreich sein, um einige Arten von Hardwareproblemen zu umgehen.
PcUnregisterAdapterPnpManagement Die PcUnregisterAdapterPnpManagement-Funktion hebt die Registrierung der PnP-Verwaltungsschnittstelle des Audioadapters beim PortCls-Klassentreiber auf. Es wird verwendet, um den PnP-Ausgleich zu unterstützen.
PcUnregisterAdapterPowerManagement Die Funktion PcUnregisterAdapterPowerManagement hebt die Registrierung der Energieverwaltungsschnittstelle des Audioadapters beim PortCls-Klassentreiber auf. Die Funktion PcUnregisterAdapterPowerManagement ist in Windows 7 und höheren Versionen von Windows verfügbar.
PcUnregisterIoTimeout Die PcUnregisterIoTimeout-Funktion hebt die Registrierung einer vom Treiber bereitgestellten I/O-Timer-Rückrufroutine für ein angegebenes Geräteobjekt auf.

Rückruffunktionen

PCPFNEVENT_HANDLER Eine EventHandler-Routine verarbeitet Ereignisanforderungen.

Strukturen

PCAUTOMATION_TABLE Die PCAUTOMATION_TABLE-Struktur enthält die master Tabelle mit Eigenschaften, Methoden und Ereignissen eines Miniporttreibers.
PCEVENT_ITEM Die PCEVENT_ITEM-Struktur wird verwendet, um ein Ereignis zu beschreiben, das von einem bestimmten Filter, Pin oder Knoten unterstützt wird.
PCEVENT_REQUEST Die PCEVENT_REQUEST-Struktur gibt eine Ereignisanforderung an.
PCFILTER_DESCRIPTOR Die PCFILTER_DESCRIPTOR-Struktur beschreibt die Implementierung eines Filters durch einen Miniporttreiber. Die -Struktur gibt die Pins, Knoten, Verbindungen und Eigenschaften des Filters an.
PCMETHOD_ITEM Die PCMETHOD_ITEM-Struktur beschreibt eine Methode, die von einem Filter, Pin oder Knoten unterstützt wird.
PCMETHOD_REQUEST Die PCMETHOD_REQUEST-Struktur gibt eine Methodenanforderung an.
PCNODE_DESCRIPTOR Die PCNODE_DESCRIPTOR-Struktur beschreibt einen Knoten im Filter, den ein Topologie-Miniporttreiber implementiert.
PCNOTIFICATION_BUFFER Der von IPortClsNotifications verwendete Benachrichtigungspuffer.
PCPIN_DESCRIPTOR Die PCPIN_DESCRIPTOR-Struktur beschreibt eine Stiftfactory.
PCPROPERTY_ITEM Die PCPROPERTY_ITEM-Struktur beschreibt eine Eigenschaft, die von einem bestimmten Filter, Pin oder Knoten unterstützt wird.
PCPROPERTY_REQUEST Die PCPROPERTY_REQUEST-Struktur gibt eine Eigenschaftsanforderung an.
PCSTREAMRESOURCE_DESCRIPTOR PCSTREAMRESOURCE_DESCRIPTOR definiert die Streamressource. Verwenden Sie PCSTREAMRESOURCE_DESCRIPTOR_INIT, um diese Struktur ordnungsgemäß zu initialisieren.

Enumerationen

eChannelTargetType Die eChannelTargetType-Enumeration definiert Konstanten, die einen Typ von Knoten (Ziel) in einem bestimmten Kanal angeben.
eEngineFormatType Die eEngineFormatType-Enumeration definiert Konstanten, die den von der Audio-Engine unterstützten Audiodatentyp angeben.
EPcMiniportEngineEvent In diesem Thema wird die EPcMiniportEngineEvent-Enumeration vorgestellt und die Parameter beschrieben, die zusätzliche Informationen bereitstellen, wenn der Miniporttreiber einen Fehler meldet.
PC_EXIT_LATENCY In diesem Thema wird die PC_EXIT_LATENCY Enumeration und die zugehörigen Member beschrieben. Die Latenzzeiten werden bestimmten maximalen Zeiten zugeordnet, in denen das Gerät seinen Ruhezustand verlassen und in den voll funktionsfähigen Zustand (D0) wechseln muss.
PC_REBALANCE_TYPE Die PC_REBALANCE_TYPE Enumeration beschreibt die Art der Unterstützung für die Neugewichtung.
PcStreamResourceType In diesem Thema wird die PcStreamResourceType-Enumeration und die zugehörigen Member beschrieben. Die PcStreamResourceType-Enumeration wird verwendet, um den Typ der Ressourcen zu definieren, die für bestimmtes Audiostreaming verwendet werden.