Funzione PcRemoveStreamResource (portcls.h)
PcRemoveStreamResource rimuove una risorsa di flusso esistente. PcRemoveStreamResource può essere chiamato da qualsiasi driver, inclusi i driver miniport WaveRT non audio, con interrupt/thread associati a un flusso audio. Può anche essere chiamato da driver miniport WaveRT audio.
Sintassi
PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
[in] PCSTREAMRESOURCE ResourceHandle
);
Parametri
[in] ResourceHandle
PCSTREAMRESOURCE: handle di risorsa restituito da PcAddStreamResource.
Per altre informazioni, vedere PcAddStreamResource e PCSTREAMRESOURCE_DESCRIPTOR.
Valore restituito
STATUS_SUCCESS: il driver è stato in grado di registrare la risorsa del PDO specificato.
STATUS_INVALID_PARAMETER: il driver restituisce questo errore se rileva qualsiasi altro parametro non valido, a parte i casi specifici per altre istanze di stato degli errori.
È possibile restituire codici di stato standard aggiuntivi.
Osservazioni
Per garantire un'operazione senza problemi, i driver audio devono registrare le risorse di streaming con portcls. In questo modo il sistema operativo può gestire le risorse per evitare interferenze tra lo streaming audio e altri sottosistemi.
Le risorse di flusso sono tutte le risorse usate dal driver audio per elaborare i flussi audio o garantire il flusso di dati audio.
I driver audio devono rimuovere una risorsa registrata in precedenza. I driver possono annullare la registrazione di una risorsa in seguito alle attività di sistema seguenti:
- Bilanciamento del dispositivo quando le risorse di I/O cambiano.
- Transizioni di alimentazione del dispositivo (D0<- ->Dx) quando le risorse vengono distrutte o create. Ad esempio, gli interrupt possono essere disconnessi quando si passa a Dx e si riconnette con il passaggio a D0.
- Quando si elaborano arresti, rimozione a sorpresa, rimuovere gli eventi plug and play.
- Quando gli endpoint audio associati vengono allontanati. Ad esempio, se viene creato un thread per gestire il flusso di dati di un endpoint e l'endpoint viene rimosso. In questo caso, il driver deve rimuovere la risorsa del flusso di thread.
I driver audio eseguiti solo in Windows 10 possono usare PcAddStreamResource e PcRemoveStreamResource. Per i driver miniport Audio waveRT che devono essere eseguiti anche nelle versioni precedenti di Windows, usare AddStreamResource e RemoveStreamResource.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10 |
| server minimo supportato | Windows Server 2016 |
| piattaforma di destinazione | Finestre |
| intestazione | portcls.h |
| libreria | Portcls.lib |
| dll | NA |
| IRQL | PASSIVE_LEVEL |