IAudioOutputEndpointRT::GetOutputDataPointer-Methode (audioengineendpoint.h)

Die GetOutputDataPointer-Methode gibt einen Zeiger auf den Ausgabepuffer zurück, in den Daten von der Audio-Engine geschrieben werden.

Syntax

UINT_PTR GetOutputDataPointer(
  [in] UINT32              u32FrameCount,
  [in] AE_CURRENT_POSITION *pAeTimeStamp
);

Parameter

[in] u32FrameCount

Die Anzahl der Frames im Ausgabepuffer, auf die der Datenzeiger verweist, der von dieser Methode zurückgegeben wird. Der Endpunkt darf diese Informationen nicht zwischenspeichern, da dies von der Audio-Engine abhängig von ihren Verarbeitungsanforderungen geändert werden kann. Weitere Informationen finden Sie in den Hinweisen.

[in] pAeTimeStamp

Ein Zeiger auf eine AE_CURRENT_POSITION-Struktur , die den Zeitstempel der gerenderten Daten angibt. Dieser Parameter ist optional.

Rückgabewert

Ein Zeiger auf den Puffer, in den Daten geschrieben werden.

Hinweise

Diese Methode gibt einen Zeiger auf einen Puffer zurück, in den die Audio-Engine Daten schreibt. Die Daten sind erst gültig, wenn die IAudioOutputEndpointRT::ReleaseOutputDataPointer-Methode aufgerufen wird. Der zurückgegebene Zeiger muss rahmenbündig ausgerichtet sein.

Die in u32FrameCount übergebene Frameanzahl muss kleiner oder gleich der maximalen Anzahl von Frames sein, die vom Endpunkt unterstützt werden. Um die maximale Frameanzahl abzurufen, die der Endpunkt unterstützen kann, ruft die Audio-Engine die IAudioEndpoint::GetFramesPerPacket-Methode auf.

Diese Methode kann aus einem Echtzeitverarbeitungsthread aufgerufen werden. Die Implementierung dieser Methode darf nicht blockieren, auf ausgelagerten Arbeitsspeicher zugreifen oder blockierende Systemroutinen aufrufen.

Die AudioEndpoint-API für Remotedesktopdienste ist für die Verwendung in Remotedesktopszenarien vorgesehen. es ist nicht für Clientanwendungen.

Anforderungen

Weitere Informationen

IAudioOutputEndpointRT