KSPROPERTY_RTAUDIO_SETWRITEPACKET
KSPROPERTY_RTAUDIO_SETWRITEPACKET informa il driver che il sistema operativo ha scritto dati validi nel buffer WaveRT.
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
| No | Sì | Aggiungi (Blocca) | KSPROPERTY | KSRTAUDIO_SETWRITEPACKET_INFO |
Il descrittore di proprietà (dati dell'istanza) è una struttura KSPROPERTY . Prima di inviare la richiesta, il client carica la struttura con valori che includono il numero di pacchetti, la lunghezza del pacchetto e altre informazioni.
Il valore della proprietà è una struttura di tipo KSRTAUDIO_SETWRITEPACKET_INFO.
Valore restituito
Una richiesta di proprietà KSPROPERTY_RTAUDIO_SETWRITEPACKET restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.
Commenti
Se questo KSPROPERTY è supportato, il driver può usare facoltativamente le informazioni fornite per ottimizzare il trasferimento hardware. Ad esempio, il driver potrebbe ottimizzare i trasferimenti DMA o l'hardware del programma per arrestare il trasferimento alla fine del pacchetto specificato nel caso in cui il sistema operativo non chiami nuovamente questa routine per informare il driver di un altro pacchetto. Ciò può attenuare gli effetti udibili del sottoflow, ad esempio introducendo un gap udibile anziché ripetere un buffer circolare. Tuttavia, il driver è ancora obbligato a aumentare i relativi contatori di pacchetti interni e segnalare gli eventi di notifica a una velocità in tempo reale nominale.
Tranne quando il sistema operativo specifica il flag di KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM , la dimensione del pacchetto è la dimensione del buffer WaveRT divisa da NotificationCount passata a KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.
A seconda delle funzionalità hardware, se viene specificato il flag di KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM , il driver può riempire in silenzio una parte del buffer WaveRT che segue il pacchetto EOS nel caso in cui i dati hardware trasferiscono i dati oltre la posizione EOS.
Requisiti
Versione |
Disponibile in Windows 10 e versioni successive dei sistemi operativi Windows. |
Intestazione |
Ksmedia.h |