IAudioInputEndpointRT::ReleaseInputDataPointer-Methode (audioengineendpoint.h)

Die ReleaseInputDataPointer-Methode gibt den abgerufenen Datenzeiger frei.

Syntax

void ReleaseInputDataPointer(
  [in] UINT32   u32FrameCount,
  [in] UINT_PTR pDataPointer
);

Parameter

[in] u32FrameCount

Die Anzahl der Frames, die von der Audio-Engine genutzt wurden. Diese Anzahl entspricht möglicherweise nicht dem Wert, der von der IAudioInputEndpointRT::GetInputDataPointer-Methode im pConnectionProperty-u32ValidFrameCount-Element > zurückgegeben wird.

[in] pDataPointer

Der Zeiger auf den Puffer, der von der GetInputDataPointer-Methode abgerufen wird, die im pConnectionProperty-pBuffer-Element> empfangen wird.

Rückgabewert

Keine

Bemerkungen

ReleaseInputDataPointer benachrichtigt den Endpunkt, dass die Audio-Engine den Eingabedatenzeiger nicht mehr benötigt, und gibt auch die Anzahl der während der Sitzung verwendeten Frames an. Beispielsweise ist ein Endpunkt, der einen Schleifenpuffer darstellt, mit der Eingabe der Audio-Engine verbunden und kann den Lesezeiger mithilfe der tatsächlichen Frameanzahl voranbringen. Wenn u32FrameCount null ist, gibt dies an, dass der Client keine Daten aus dem angegebenen Eingabepuffer verwendet hat. Der u32FrameCount muss kleiner oder gleich der maximalen Frameanzahl sein, die vom Endpunkt unterstützt wird. Um die unterstützte Anzahl von Frames abzurufen, 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

IAudioInputEndpointRT