Metodo IAudioCaptureClient::GetNextPacketSize (audioclient.h)

Il metodo GetNextPacketSize recupera il numero di fotogrammi nel pacchetto di dati successivo nel buffer dell'endpoint di acquisizione.

Sintassi

HRESULT GetNextPacketSize(
  [out] UINT32 *pNumFramesInNextPacket
);

Parametri

[out] pNumFramesInNextPacket

Puntatore a una variabile UINT32 in cui il metodo scrive il conteggio dei fotogrammi (numero di fotogrammi audio nel pacchetto di acquisizione successivo).

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito Descrizione
AUDCLNT_E_DEVICE_INVALIDATED
Il dispositivo endpoint audio è stato scollegato o l'hardware audio o le risorse hardware associate sono state riconfigurate, disabilitate, rimosse o altrimenti non disponibili per l'uso.
AUDCLNT_E_SERVICE_NOT_RUNNING
Il servizio audio Di Windows non è in esecuzione.
E_POINTER
Il parametro pNumFramesInNextPacket è NULL.

Commenti

Usare questo metodo solo con flussi in modalità condivisa. Non funziona con flussi in modalità esclusiva.

Prima di chiamare il metodo IAudioCaptureClient::GetBuffer per recuperare il pacchetto di dati successivo, il client può chiamare GetNextPacketSize per recuperare il numero di fotogrammi audio nel pacchetto successivo. Il conteggio segnalato da GetNextPacketSize corrisponde al conteggio recuperato nella chiamata GetBuffer (tramite il parametro di output pNumFramesToRead ) che segue la chiamata GetNextPacketSize .

Un pacchetto è sempre costituito da un numero integrale di fotogrammi audio.

GetNextPacketSize deve essere chiamato nello stesso thread del metodo GetBuffer e IAudioCaptureClient::ReleaseBuffer che ottengono e rilasciano i pacchetti nel buffer dell'endpoint di acquisizione.

Per un esempio di codice che usa il metodo GetNextPacketSize, vedere Acquisizione di un Stream.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione audioclient.h

Vedi anche

Interfaccia IAudioCaptureClient

IAudioCaptureClient::GetBuffer

IAudioCaptureClient::ReleaseBuffer

IAudioClient::GetCurrentPadding