IMiniportAudioSignalProcessing::GetModes-Methode (portcls.h)
Die GetModes-Methode ruft die Audiosignalverarbeitungsmodi ab, die von einem Audio-Pin unterstützt werden.
Syntax
NTSTATUS GetModes(
[in] ULONG Pin,
[out, optional] GUID *SignalProcessingModes,
[in, out] ULONG *NumSignalProcessingModes
);
Parameter
[in] Pin
Der Index des Audio-Pins.
[out, optional] SignalProcessingModes
Dieser Parameter ist optional. Es gibt ein Array von GUIDs zurück, die die vom Pin-Parameter unterstützten Signalverarbeitungsmodi identifizieren.
[in, out] NumSignalProcessingModes
Wenn sie als Eingabe verwendet wird, gibt sie die Anzahl der Elemente an, die in den in SignalProcessingModes angegebenen Puffer geschrieben werden können. Wenn sie als Ausgabe verwendet wird, wird die Anzahl der Elemente zurückgegeben, die in den Puffer geschrieben wurden.
Rückgabewert
GetModes gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.
Hinweise
Wenn SignalProcessingModes NULL ist, schreibt GetModes die Anzahl der unterstützten Modi in NumSignalProcessingModes und gibt STATUS_SUCCESS zurück. Dadurch können Aufrufer die Anzahl der unterstützten Modi abfragen, um Puffer zuzuweisen.
Wenn SignalProcessingModes nicht NULL ist, überprüft GetModes , ob NumSignalProcessingModes größer oder gleich der Anzahl der unterstützten Modi ist. Wenn dies der Fall ist, schreibt die Methode die unterstützten Modi in den SignalProcessingModes-Puffer , schreibt die tatsächliche Anzahl der unterstützten Modi in NumSignalProcessingModes und gibt STATUS_SUCCESS zurück.
In der folgenden Tabelle werden die Fehlermeldungen aufgeführt und erläutert, die von GetModes zurückgegeben werden können.
| Fehlercode | BESCHREIBUNG |
|---|---|
| STATUS_BUFFER_TOO_SMALL | Der Puffer, der für NumSignalProcessingModes reserviert wurde, ist zu klein. |
| STATUS_INVALID_PARAMETER | Der Wert des Pin-Parameters gibt eine Pin-ID an, die >= die Anzahl der Pinfactorys im Filter ist. Der Pinindex ist nullbasiert, sodass für n Pin-Fabriken in einem Filter der höchste Indexwert n-1 sein sollte. |
| STATUS_NOT_SUPPORTED | Eine Pin-ID wurde für einen Pin angegeben, der keine Signalverarbeitungsmodi unterstützt. Wenn sich die Pin-ID beispielsweise auf eine Audioschleifen-Pin oder einen Bridge-Pin bezieht, gibt GetModes diesen Fehlercode zurück. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 |
| Zielplattform | Universell |
| Header | portcls.h |