Funzione PcAddStreamResource (portcls.h)
PcAddStreamResource aggiunge una risorsa di flusso. Sono supportati due tipi di risorse di flusso: interrupt e thread di proprietà del driver. PcAddStreamResource può essere chiamato da qualsiasi 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 PcAddStreamResource(
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in] PVOID ResourceSet,
[in] PPCSTREAMRESOURCE_DESCRIPTOR ResourceDescriptor,
[out] PCSTREAMRESOURCE *ResourceHandle
);
Parametri
[in] PhysicalDeviceObject
PDEVICE_OBJECT: pdo dello stack di dispositivi usando questa risorsa.
[in] ResourceSet
PVOID: riservato per uso futuro, impostato su NULL. Attualmente 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 di risorsa. Per altre informazioni, vedere PcRemoveStreamResource.
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.
Tutti i driver audio devono registrare le risorse di flusso con il driver della classe audio. Il driver registra i tipi di risorse seguenti: interrupt, thread di proprietà del driver e dipendenze da altre risorse dello 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 durante l'esecuzione di 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.
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 |