Condividi tramite

Metodo IPortClsStreamResourceManager::RemoveStreamResource (portcls.h)

  • Articolo

RemoveStreamResource rimuove una risorsa di flusso esistente. Il metodo RemoveStreamResource può essere usato solo dai driver miniport audio waveRT.

Sintassi

NTSTATUS RemoveStreamResource(
  PCSTREAMRESOURCE ResourceHandle
);

Parametri

ResourceHandle

PCSTREAMRESOURCE: handle di risorse 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 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.

Il driver audio deve assicurarsi che la risorsa sia valida durante l'esecuzione di questa chiamata.

Requisiti

Requisito Valore
Intestazione portcls.h
IRQL PASSIVE_LEVEL

Vedi anche

IPortClsStreamResourceManager