PcAddStreamResource-Funktion (portcls.h)
PcAddStreamResource fügt eine Streamressource hinzu. Zwei Arten von Datenstromressourcen werden unterstützt: Interrupts und Treiberthreads. PcAddStreamResource kann von jedem Nicht-Audio WaveRT-Miniporttreiber aufgerufen werden, der Unterbrechungen/Threads aufweist, die einem Audiodatenstrom zugeordnet sind. Sie kann auch von Audio WaveRT-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 mithilfe dieser Ressource.
[in] ResourceSet
PVOID - Reserviert für die zukünftige Verwendung, auf NULL festgelegt. Derzeit werden nur gerätebezogene Ressourcen 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 ungültigen Parameter findet, abgesehen von den spezifischen Fällen für andere Fehlerstatusinstanzen.
Zusätzliche Standardstatuscodes können zurückgegeben werden.
Bemerkungen
Um den Glitch-freien Betrieb zu gewährleisten, müssen Audiotreiber ihre Streamingressourcen bei Portcls registrieren. Auf diese Weise kann das Betriebssystem Ressourcen verwalten, um Störungen zwischen Audiostreaming und anderen Subsystemen zu vermeiden.
Streamressourcen sind alle Ressourcen, die vom Audiotreiber zum Verarbeiten von Audiodatenströmen oder zum Sicherstellen des Audiodatenflusses verwendet werden.
Alle Audiotreiber müssen ihre Streamressourcen beim Audioklassentreiber registrieren. Der Treiber registriert die folgenden Ressourcentypen: Interrupts, Treiberthreads und Abhängigkeiten von den Ressourcen anderer Audiostapel (Beispiel: parallele Audiotreiberstapel). Weitere Informationen finden Sie in der Definition von PCSTREAMRESOURCE_DESCRIPTOR.
Der Audiotreiber muss sicherstellen, dass die Ressource beim Ausführen dieses Aufrufs gültig ist.
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 |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Fenster |
| Header- | portcls.h |
| Library | Portcls.lib |
| DLL- | NA |
| IRQL- | PASSIVE_LEVEL |