IAudioCaptureClient::GetNextPacketSize-Methode (audioclient.h)

  • Artikel

Die GetNextPacketSize-Methode ruft die Anzahl der Frames im nächsten Datenpaket im Erfassungsendpunktpuffer ab.

Syntax

HRESULT GetNextPacketSize(
  [out] UINT32 *pNumFramesInNextPacket
);

Parameter

[out] pNumFramesInNextPacket

Zeiger auf eine UINT32-Variable , in die die -Methode die Frameanzahl schreibt (die Anzahl der Audioframes im nächsten Erfassungspaket).

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
AUDCLNT_E_DEVICE_INVALIDATED
 Das Audioendpunktgerät wurde getrennt, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig für die Verwendung nicht verfügbar gemacht.
AUDCLNT_E_SERVICE_NOT_RUNNING
 Der Windows-Audiodienst wird nicht ausgeführt.
E_POINTER
 Der Parameter pNumFramesInNextPacket ist NULL.

Hinweise

Verwenden Sie diese Methode nur mit Datenströmen im freigegebenen Modus. Es funktioniert nicht mit Datenströmen im exklusiven Modus.

Vor dem Aufrufen der IAudioCaptureClient::GetBuffer-Methode zum Abrufen des nächsten Datenpakets kann der Client GetNextPacketSize aufrufen, um die Anzahl der Audioframes im nächsten Paket abzurufen. Die von GetNextPacketSize gemeldete Anzahl entspricht der Anzahl, die im GetBuffer-Aufruf abgerufen wurde (über den Ausgabeparameter pNumFramesToRead ), der dem GetNextPacketSize-Aufruf folgt.

Ein Paket besteht immer aus einer integralen Anzahl von Audioframes.

GetNextPacketSize muss im selben Thread wie die GetBuffer - und IAudioCaptureClient::ReleaseBuffer-Methodenaufrufe aufgerufen werden, die die Pakete im Erfassungsendpunktpuffer abrufen und freigeben.

Ein Codebeispiel, das die GetNextPacketSize-Methode verwendet, finden Sie unter Erfassen einer Stream.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile audioclient.h

Weitere Informationen

IAudioCaptureClient-Schnittstelle

IAudioCaptureClient::GetBuffer

IAudioCaptureClient::ReleaseBuffer

IAudioClient::GetCurrentPadding