IXAPO::LockForProcess-Methode (xapo.h)

  • Artikel

Wird von XAudio2 aufgerufen, um die Eingabe- und Ausgabekonfigurationen eines XAPO zu sperren, sodass es eine endgültige Initialisierung durchführen kann, bevor Process im Echtzeitthread aufgerufen wird.

Syntax

HRESULT LockForProcess(
  UINT32                               InputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pInputLockedParameters,
  UINT32                               OutputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pOutputLockedParameters
);

Parameter

InputLockedParameterCount

Anzahl der Elemente in ppInputLockedParameters. Muss innerhalb der XAPO_REGISTRATION_PROPERTIES sein. MinInputBufferCount und XAPO_REGISTRATION_PROPERTIES. MaxInputBufferCount-Werte werden an CXAPOBase::CXAPOBase übergeben.

pInputLockedParameters

Array von Eingabe-XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS-Strukturen . pInputLockedParameters kann NULL sein, wenn InputLockedParameterCount 0 ist, andernfalls muss es Über InputLockedParameterCount-Elemente verfügen.

OutputLockedParameterCount

Anzahl der Elemente in ppOutputLockedParameters. Muss innerhalb der XAPO_REGISTRATION_PROPERTIES sein. MinOutputBufferCount und XAPO_REGISTRATION_PROPERTIES. MaxOutputBufferCount-Werte, die an CXAPOBase::CXAPOBase übergeben werden. Wenn das XAPO_FLAG_BUFFERCOUNT_MUST_MATCH-Flag in XAPO_REGISTRATION_PROPERTIES angegeben wurde. Flags dann OutputLockedParameterCount muss gleich InputLockedParameterCount sein.

pOutputLockedParameters

Array von Ausgabe XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS strukturen. pOutputLockedParameters kann NULL sein, wenn OutputLockedParameterCount 0 ist, andernfalls muss es Über OutputLockedParameterCount-Elemente verfügen.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück, andernfalls einen Fehlercode.

Hinweise

Nach dem Sperren bleiben die Eingabe- und Ausgabekonfiguration und alle anderen gesperrten Parameter konstant, bis UnLockForProcess aufgerufen wird. Nachdem ein XAPO gesperrt wurde, wirken sich weitere Aufrufe von LockForProcess erst dann aus, wenn die UnLockForProcess-Funktion aufgerufen wird.

Ein XAPO gibt an, welche spezifischen Formate durch die Implementierung der Methoden IsInputFormatSupported und IsOutputFormatSupported unterstützt werden . Ein XAPO sollte behaupten, dass die Eingabe- und Ausgabekonfigurationen unterstützt werden und dass alle erforderlichen effektspezifischen Initialisierungen abgeschlossen sind. Die Methoden IsInputFormatSupported, IsOutputFormatSupported und Initialize sollten nach Bedarf verwendet werden, bevor diese Methode aufgerufen wird.

Da Process eine nicht blockierende Methode ist, sollten alle internen Speicherpuffer, die für Process erforderlich sind, in LockForProcess zugeordnet werden.

Der Prozess wird nie aufgerufen, bevor LockForProcess erfolgreich zurückgegeben wird.

LockForProcess wird direkt von XAudio2 aufgerufen und sollte nicht vom Clientcode aufgerufen werden.

Plattformanforderungen

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Requirements (Anforderungen)

   
Zielplattform Windows
Kopfzeile xapo.h

Weitere Informationen

IXAPO