IAudioProcessingObjectConfiguration::LockForProcess-Methode (audioenginebaseapo.h)
Die LockForProcess
-Methode wird verwendet, um zu überprüfen, ob der APO gesperrt ist und bereit ist, Daten zu verarbeiten.
Syntax
HRESULT LockForProcess(
[in] UINT32 u32NumInputConnections,
[in] APO_CONNECTION_DESCRIPTOR **ppInputConnections,
[in] UINT32 u32NumOutputConnections,
[in] APO_CONNECTION_DESCRIPTOR **ppOutputConnections
);
Parameter
[in] u32NumInputConnections
Anzahl der Eingabeverbindungen, die an diesen APO angefügt sind.
[in] ppInputConnections
Verbindungsdeskriptor für jede Eingabeverbindung, die an diesen APO angefügt ist.
[in] u32NumOutputConnections
Anzahl der Ausgabeverbindungen, die an diesen APO angefügt sind.
[in] ppOutputConnections
Verbindungsdeskriptor für jede Ausgabeverbindung, die an diesen APO angefügt ist.
Rückgabewert
Die LockForProcess
-Methode gibt den Wert S_OK zurück, wenn der Aufruf erfolgreich abgeschlossen wurde. In dieser Phase ist der APO gesperrt und bereit, Daten zu verarbeiten.
Rückgabecode | Beschreibung |
---|---|
|
Ein ungültiger Zeiger wurde an die Funktion übergeben. |
|
Ungültiges Verbindungsformat. |
|
Anzahl der für diesen APO ungültigen Eingabe- oder Ausgabeverbindungen. |
|
APO ist bereits gesperrt. |
|
Diese Fehler werden von der Audio-Engine nachverfolgt. |
Hinweise
Wenn die LockForProcess
-Methode aufgerufen wird, führt sie zunächst eine interne Überprüfung durch, um festzustellen, ob der APO initialisiert wurde und bereit ist, Daten zu verarbeiten. Jeder APO hat unterschiedliche Initialisierungsanforderungen, sodass jeder APO bei Bedarf eine eigene Initialize-Methode definieren muss.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar mit Windows Vista und höheren Versionen des Windows-Betriebssystems. |
Zielplattform | Universell |
Header | audioenginebaseapo.h |
Bibliothek | Audioenginebaseapo.idl |
IRQL | Alle Ebenen |