PcAddStreamResource-Funktion (portcls.h)
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 |