PcAddStreamResource-Funktion (portcls.h)

  • Artikel

PcAddStreamResource fügt eine Streamressource hinzu. Zwei Arten von Streamressourcen werden unterstützt: Interrupts und treibereigene Threads. PcAddStreamResource kann von jedem Nicht-Audio-WaveRT-Miniporttreiber aufgerufen werden, der über Interrupts/Threads verfügt, die einem Audiodatenstrom zugeordnet sind. Es kann auch von WaveRT-Audio-Miniporttreibern aufgerufen werden.

Syntax

PORTCLASSAPI NTSTATUS PcAddStreamResource(
  [in]  PDEVICE_OBJECT               PhysicalDeviceObject,
  [in]  PVOID                        ResourceSet,
  [in]  PPCSTREAMRESOURCE_DESCRIPTOR ResourceDescriptor,
  [out] PCSTREAMRESOURCE             *ResourceHandle
);

Parameter

[in] PhysicalDeviceObject

PDEVICE_OBJECT: Die PDO des Gerätestapels, der diese Ressource verwendet.

[in] ResourceSet

PVOID: Für zukünftige Verwendung reserviert, auf NULL festgelegt. Derzeit werden nur Geräteressourcen unterstützt.

[in] ResourceDescriptor

PPCSTREAMRESOURCE_DESCRIPTOR: Die hinzuzufügende Ressource. Weitere Informationen finden Sie unter PCSTREAMRESOURCE_DESCRIPTOR.

[out] ResourceHandle

PCSTREAMRESOURCE*: Der Speicherort, der das Ressourcenhandle enthält. Weitere Informationen finden Sie unter PcRemoveStreamResource.

Rückgabewert

STATUS_SUCCESS: Der Treiber konnte die Ressource der angegebenen PDO registrieren.

STATUS_INVALID_PARAMETER : Der Treiber gibt diesen Fehler zurück, wenn er einen anderen Parameter ungültig findet, abgesehen von den spezifischen Fällen für andere Fehler status Instanzen.

Zusätzliche Standardcodes status können zurückgegeben werden.

Hinweise

Um einen störungsfreien Betrieb sicherzustellen, müssen Audiotreiber ihre Streamingressourcen bei portcls registrieren. Dadurch kann das Betriebssystem Ressourcen verwalten, um Störungen zwischen Audiostreaming und anderen Subsystemen zu vermeiden.

Stream Ressourcen sind alle Ressourcen, die vom Audiotreiber zum Verarbeiten von Audiostreams oder zum Sicherstellen des Audiodatenflusses verwendet werden.

Alle Audiotreiber müssen ihre Streamressourcen beim Audioklassentreiber registrieren. Der Treiber registriert die folgenden Ressourcentypen: Interrupts, treibereigene Threads und Abhängigkeiten von ressourcen des anderen Audiostapels (Beispiel: parallele Audiotreiberstapel). Weitere Informationen finden Sie in der Definition von PCSTREAMRESOURCE_DESCRIPTOR .

Der Audiotreiber muss sicherstellen, dass die Ressource gültig ist, wenn dieser Aufruf ausgeführt wird.

Audiotreiber, die nur in Windows 10 ausgeführt werden, können PcAddStreamResource und PcRemoveStreamResource verwenden. Verwenden Sie für Audio waveRT-Miniporttreiber, die auch unter früheren Versionen von Windows ausgeführt werden müssen, AddStreamResource und RemoveStreamResource.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
Kopfzeile portcls.h
Bibliothek Portcls.lib
DLL Nicht verfügbar
IRQL PASSIVE_LEVEL

Weitere Informationen

PCSTREAMRESOURCE_DESCRIPTOR

PcRemoveStreamResource