IAudioProcessingObjectConfiguration::LockForProcess-Methode (audioenginebaseapo.h)

  • Artikel

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
E_POINTER
 Ein ungültiger Zeiger wurde an die Funktion übergeben.
APOERR_INVALID_CONNECITON_FORMAT
 Ungültiges Verbindungsformat.
APOERR_NUM_CONNECTIONS_INVALID
 Anzahl der für diesen APO ungültigen Eingabe- oder Ausgabeverbindungen.
APOERR_APO_LOCKED
 APO ist bereits gesperrt.
Andere HRESULTS
 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