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, che ha interruzioni/thread associati a un flusso audio. Può anche essere chiamato dai driver miniport audio WaveRT.
Sintassi
PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
[in] PCSTREAMRESOURCE ResourceHandle
);
Parametri
[in] ResourceHandle
PCSTREAMRESOURCE: handle di risorse restituito da PcAddStreamResource.
Per altre informazioni, vedere PcAddStreamResource e PCSTREAMRESOURCE_DESCRIPTOR.
Valore restituito
STATUS_SUCCESS: il driver è stato in grado di registrare la risorsa dell'oggetto PDO specificato.
STATUS_INVALID_PARAMETER: il driver restituisce questo errore se trova qualsiasi altro parametro non valido, a parte i casi specifici per altre istanze di stato degli errori.
È possibile restituire altri codici di stato standard.
Commenti
Per garantire un'operazione senza interruzioni, i driver audio devono registrare le risorse di streaming con portcls. Ciò consente al sistema operativo di gestire le risorse per evitare l'interferenza tra streaming audio e altri sottosistemi.
Stream risorse 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 eliminate o create. Ad esempio, gli interruzioni possono essere disconnessi quando si passa a Dx e si riconnette con lo spostamento a D0.
- Quando si elabora l'arresto, la rimozione a sorpresa, rimuovere gli eventi plug and play.
- Quando gli endpoint audio associati vanno via. 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 di flusso del 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 |
| Server minimo supportato | Windows Server 2016 |
| Piattaforma di destinazione | Windows |
| Intestazione | portcls.h |
| Libreria | Portcls.lib |
| DLL | ND |
| IRQL | PASSIVE_LEVEL |