KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT
La proprietà KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT annulla la registrazione di un evento in modalità utente dalla notifica degli eventi guidata da DMA.
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_UNREGISTER_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 annullare la registrazione degli eventi in modalità utente dalla 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 per ciclo del buffer audio ciclico, a seconda del conteggio delle notifiche richiesto quando è stato chiamato KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION . Per altre informazioni sulle KSSTATE_RUN, vedere l'argomento Transizioni di stato .
Dopo aver arrestato il pin e prima del passaggio in cui lo si chiude, ogni evento registrato deve essere 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
KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY