IMiniportAudioSignalProcessing::GetModes-Methode (portcls.h)
Die GetModes-Methode ruft die Audiosignalverarbeitungsmodi ab, die von einer Audio-Pin unterstützt werden.
Syntax
NTSTATUS GetModes(
[in] ULONG Pin,
[out, optional] GUID *SignalProcessingModes,
[in, out] ULONG *NumSignalProcessingModes
);
Parameter
[in] Pin
Der Index der Audio-Pin.
[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 SignalProcessingModesin den Puffer geschrieben werden können. Wenn sie als Ausgabe verwendet wird, gibt sie die Anzahl der Elemente zurück, 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.
Bemerkungen
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 Grund ist, schreibt die Methode die unterstützten Modi in den SignalProcessingModes Puffer, schreibt die tatsächliche Anzahl der unterstützten Modi in NumSignalProcessingModesund gibt STATUS_SUCCESS zurück.
In der folgenden Tabelle werden die Fehlermeldungen dargestellt und erläutert, als von GetModeszurückgegeben werden können.
| Fehlercode | Beschreibung |
|---|---|
| STATUS_BUFFER_TOO_SMALL | Der Puffer, der für NumSignalProcessingModes festgelegt wurde, ist zu klein. |
| STATUS_INVALID_PARAMETER | Der Wert des parameters Pin gibt eine Pin-ID an, die >= die Anzahl der Pin-Fabriken für den Filter ist. Der Pinindex ist nullbasiert, sodass für n Pin-Fabriken für einen Filter der höchste Indexwert n-1 sein sollte. |
| STATUS_NOT_SUPPORTED | Für einen Pin wurde eine Pin-ID angegeben, die keine Signalverarbeitungsmodi unterstützt. Wenn sich die Pin-ID beispielsweise auf eine Audioschleifen-Pin oder einen Brückennadel bezieht, gibt GetModes- diesen Fehlercode zurück. |
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1 |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Zielplattform- | Universal |
| Header- | portcls.h |