IPortClsStreamResourceManager::RemoveStreamResource-Methode (portcls.h)
RemoveStreamResource entfernt eine vorhandene Streamressource. Die RemoveStreamResource-Methode kann nur von Audio waveRT-Miniporttreibern verwendet werden.
Syntax
NTSTATUS RemoveStreamResource(
PCSTREAMRESOURCE ResourceHandle
);
Parameter
ResourceHandle
PCSTREAMRESOURCE: Ressourcenhandle, das von PcAddStreamResource zurückgegeben wird. Weitere Informationen finden Sie unter PcAddStreamResource.
Rückgabewert
Diese Methode gibt NTSTATUS zurück, das Folgendes enthält:
- 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äteleistungsü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.
Der Audiotreiber muss bei diesem Aufruf sicherstellen, dass die Ressource gültig ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | portcls.h |
| IRQL | PASSIVE_LEVEL |