PcRemoveStreamResource-Funktion (portcls.h)
PcRemoveStreamResource entfernt eine vorhandene Streamressource. PcRemoveStreamResource kann von jedem Treiber aufgerufen werden, einschließlich Nicht-Audio-WaveRT-Miniporttreibern, der Interrupts/Threads aufweist, die einem Audiostream zugeordnet sind. Es 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 des 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.
Es können zusätzliche Standard-status-Codes 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 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:
- Das Gerät wird neu ausgeglichen, wenn sich E/A-Ressourcen ändern.
- Geräteenergieübergänge (D0<->Dx), wenn Ressourcen zerstört oder erstellt werden. Beispielsweise können Unterbrechungen getrennt werden, wenn sie in Dx wechseln und mit dem Wechsel zu D0 wieder verbunden werden.
- Wenn Die Verarbeitung beendet, überraschend entfernt wird, entfernen Sie Plug-and-Play-Ereignisse.
- Wenn zugeordnete Audioendpunkte entfernt werden. Beispielsweise, wenn ein Thread erstellt wird, um den Datenstrom eines Endpunkts zu behandeln, 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 AddStreamResource und RemoveStreamResource für Audio waveRT-Miniporttreiber, die auch unter früheren Windows-Versionen ausgeführt werden müssen.
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 |