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 e, Restituisce una matrice di GUID che identificano le modalità di elaborazione del segnale supportate dal parametro Pin .
[in, out] NumSignalProcessingModes
Se usato come input, specifica il numero di elementi che possono essere scritti nel buffer specificato in SignalProcessingModes. Se 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.
Commenti
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 NumSignalProcessingModes e restituisce STATUS_SUCCESS.
La tabella seguente presenta e illustra 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 del segnale. Ad esempio, se l'ID pin fa riferimento a un pin di loopback audio o a un pin di bridge, GetModes restituirà questo codice di errore. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8.1 |
| Server minimo supportato | Windows Server 2012 R2 |
| Piattaforma di destinazione | Universale |
| Intestazione | portcls.h |