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 |
|---|---|
|
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. |
|
Il servizio audio Di Windows non è in esecuzione. |
|
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