Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
PcRemoveStreamResource entfernt eine vorhandene Streamressource. PcRemoveStreamResource kann von jedem Treiber aufgerufen werden, einschließlich Nicht-Audio WaveRT-Miniporttreibern, die Unterbrechungen/Threads aufweisen, die einem Audiodatenstrom zugeordnet sind. Sie kann auch von Audio WaveRT-Miniporttreibern aufgerufen werden.
Syntax
PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
[in] PCSTREAMRESOURCE ResourceHandle
);
Parameter
[in] ResourceHandle
PCSTREAMRESOURCE– Ressourcenhandle, das von PcAddStreamResource zurückgegeben wird.
Weitere Informationen finden Sie unter PcAddStreamResource- und PCSTREAMRESOURCE_DESCRIPTOR.
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.
Audiotreiber müssen eine zuvor registrierte Ressource entfernen. Treiber können die Registrierung einer Ressource aufgrund der folgenden Systemaktivitäten aufheben:
- Gerät wieder ausgeglichen, wenn sich E/A-Ressourcen ändern.
- Gerätestromübergänge (D0<- ->Dx), wenn Ressourcen zerstört oder erstellt werden. So können z. B. Unterbrechungen getrennt werden, wenn sie in Dx gehen und wieder mit dem Wechsel zu D0 verbunden sind.
- Beim Verarbeiten des Stopps entfernen Sie Plug-and-Play-Ereignisse, überraschungserfernen, entfernen und wiedergeben.
- Wenn zugeordnete Audioendpunkte weggehen. Beispiel: Wenn ein Thread zum Behandeln des Datenstroms eines Endpunkts erstellt wird und der Endpunkt entfernt wird. In diesem Fall sollte der Treiber die Threadstreamressource entfernen.
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 |