KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT
La proprietà KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT registra un evento in modalità utente per la notifica degli eventi guidata da DMA. Gli eventi devono essere registrati dopo aver chiamato correttamente KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.
Nella tabella seguente vengono riepilogate le funzionalità di questa proprietà.
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
Sì |
Sì |
Aggiungi (Blocca) |
NULL |
Il descrittore di proprietà (dati dell'istanza) è costituito da una struttura KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY che contiene una struttura KSPROPERTY insieme a un handle di eventi in modalità utente.
Il valore della proprietà (dati dell'operazione) per questa proprietà è NULL perché non vengono restituiti dati delle operazioni.
Valore restituito
Una richiesta di proprietà KSPROPERTY_ RTAUDIO_REGISTER_NOTIFICATION_EVENT restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato. La tabella seguente mostra alcuni dei possibili codici di stato degli errori.
| Codice stato | Significato |
|---|---|
STATUS_NOT_SUPPORTED |
Le notifiche degli eventi non sono supportate. |
STATUS_INSUFFICIENT_RESOURCES |
Impossibile allocare la memoria per il buffer. |
STATUS_DEVICE_NOT_READY |
Il dispositivo non è pronto. |
Commenti
Questa proprietà viene usata per registrare gli eventi in modalità utente per la notifica degli eventi guidata da DMA.
Quando il pin viene inserito nello stato di esecuzione (KSSTATE_RUN) gli eventi registrati vengono segnalati una o due volte al ciclo del buffer audio ciclico, a seconda del conteggio delle notifiche richiesto quando è stato chiamato KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION. Per altre informazioni su KSSTATERUN, vedere l'argomento Transizioni di stato .
Dopo aver arrestato il pin e prima dell'ora di chiusura, ogni evento registrato viene annullato tramite una chiamata a KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT.
Requisiti
Versione |
Disponibile in Windows Vista e nei sistemi operativi Windows successivi. |
Intestazione |
Ksmedia.h |
Vedere anche
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION