PcRemoveStreamResource-Funktion (portcls.h)

  • Artikel

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.
Der Audiotreiber muss bei diesem Aufruf sicherstellen, dass die Ressource gültig ist.

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

Weitere Informationen

PCSTREAMRESOURCE_DESCRIPTOR

PcAddStreamResource

PcStreamResourceType