Metodo IMiniportAudioSignalProcessing::GetModes (portcls.h)
Il metodo GetModes recupera le modalità di elaborazione dei segnali audio supportate da un pin audio.
Sintassi
NTSTATUS GetModes(
[in] ULONG Pin,
[out, optional] GUID *SignalProcessingModes,
[in, out] ULONG *NumSignalProcessingModes
);
Parametri
[in] Pin
Indice del pin audio.
[out, optional] SignalProcessingModes
Questo parametro è facoltativo. Restituisce una matrice di GUID che identificano le modalità di elaborazione dei segnali supportate dal parametro pin.
[in, out] NumSignalProcessingModes
Quando viene usato come input, specifica il numero di elementi che possono essere scritti nel buffer specificato in SignalProcessingModes. Quando viene usato come output, restituisce il numero di elementi scritti nel buffer.
Valore restituito
getModes restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.
Osservazioni
Se SignalProcessingModes è NULL, GetModes scrive il numero di modalità supportate in NumSignalProcessingModes e restituisce STATUS_SUCCESS. In questo modo i chiamanti possono eseguire query sul numero di modalità supportate per allocare buffer.
Se SignalProcessingModes non è NULL, GetModes verifica che NumSignalProcessingModes sia maggiore o uguale al numero di modalità supportate. In caso affermativo, il metodo scrive le modalità supportate nel buffer SignalProcessingModes, scrive il numero effettivo di modalità supportate in NumSignalProcessingModese restituisce STATUS_SUCCESS.
La tabella seguente presenta e spiega i messaggi di errore che possono essere restituiti da GetModes.
| Codice di errore | Descrizione |
|---|---|
| STATUS_BUFFER_TOO_SMALL | Il buffer che è stato messo da parte per NumSignalProcessingModes è troppo piccolo. |
| STATUS_INVALID_PARAMETER | Il valore del parametro pin indica un ID pin >= il numero di pin factory nel filtro. L'indice pin è in base zero, quindi per n pin factory in un filtro, il valore di indice più alto deve essere n-1. |
| STATUS_NOT_SUPPORTED | È stato specificato un ID pin per un pin che non supporta le modalità di elaborazione dei segnali. Ad esempio, se l'ID pin fa riferimento a un pin di loopback audio o a un pin bridge, GetModes restituirà questo codice di errore. |
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 8.1 |
| server minimo supportato | Windows Server 2012 R2 |
| piattaforma di destinazione | Universale |
| intestazione | portcls.h |