IAudioCaptureClient::GetNextPacketSize-Methode (audioclient.h)
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 |
|---|---|
|
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. |
|
Der Windows-Audiodienst wird nicht ausgeführt. |
|
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