Funzione PcAddStreamResource (portcls.h)

PcAddStreamResource aggiunge una risorsa di flusso. Sono supportati due tipi di risorse di flusso: interruzioni e thread di proprietà del driver. PcAddStreamResource può essere chiamato da qualsiasi driver miniport WaveRT non audio con interruzioni/thread associati a un flusso audio. Può anche essere chiamato dai driver miniport audio WaveRT.

Sintassi

PORTCLASSAPI NTSTATUS PcAddStreamResource(
  [in]  PDEVICE_OBJECT               PhysicalDeviceObject,
  [in]  PVOID                        ResourceSet,
  [in]  PPCSTREAMRESOURCE_DESCRIPTOR ResourceDescriptor,
  [out] PCSTREAMRESOURCE             *ResourceHandle
);

Parametri

[in] PhysicalDeviceObject

PDEVICE_OBJECT: l'oggetto PDO dello stack di dispositivi usando questa risorsa.

[in] ResourceSet

PVOID: riservato per l'uso futuro, impostato su NULL. In questo momento sono supportate solo le risorse con ambito dispositivo.

[in] ResourceDescriptor

PPCSTREAMRESOURCE_DESCRIPTOR : risorsa da aggiungere. Per altre informazioni, vedere PCSTREAMRESOURCE_DESCRIPTOR.

[out] ResourceHandle

PCSTREAMRESOURCE* - Percorso che conterrà l'handle delle risorse. Per altre informazioni, vedere PcRemoveStreamResource.

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.

Tutti i driver audio devono registrare le risorse di flusso con il driver della classe audio. Il driver registra i tipi di risorse seguenti: interrompe, thread di proprietà del driver e dipendenze sulle risorse di altri stack audio (ad esempio: stack di driver audio paralleli). Per altre informazioni, vedere la definizione di PCSTREAMRESOURCE_DESCRIPTOR .

Il driver audio deve assicurarsi che la risorsa sia valida quando si effettua questa chiamata.

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

Vedi anche

PCSTREAMRESOURCE_DESCRIPTOR

PcRemoveStreamResource