Metodo IPortClsStreamResourceManager::RemoveStreamResource (portcls.h)
RemoveStreamResource rimuove una risorsa di flusso esistente. Il metodo RemoveStreamResource può essere usato solo dai driver miniport waveRT audio.
Sintassi
NTSTATUS RemoveStreamResource(
PCSTREAMRESOURCE ResourceHandle
);
Parametri
ResourceHandle
PCSTREAMRESOURCE: handle di risorsa restituito da PcAddStreamResource. Per altre informazioni, vedere PcAddStreamResource.
Valore restituito
Questo metodo restituisce NTSTATUS che contiene:
- 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.
Il driver audio deve assicurarsi che la risorsa sia valida durante l'esecuzione di questa chiamata.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | portcls.h |
| IRQL | PASSIVE_LEVEL |