Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La proprietà CODECAPI_ALLSETTINGS viene usata per passare avanti e indietro un blocco di dati generato da minidriver.
| Ottieni | Impostare | Obiettivo | Tipo descrittore di proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
| Sì | Sì | Filtro | KSPROPERTY | PVOID |
Il valore della proprietà (dati dell'operazione) è di tipo PVOID, ovvero un puntatore a un buffer in modalità utente per il blocco di dati generato dal minidriver.
Commenti
In una chiamata get della proprietà:
Se un'applicazione effettua una chiamata a una proprietà get con un buffer di lunghezza zero, il minidriver deve restituire STATUS_BUFFER_OVERFLOW e specificare le dimensioni del buffer necessarie nel campo Irp->IoStatus.Information. Se il buffer di lunghezza è diverso da zero, il minidriver deve restituire STATUS_BUFFER_TOO_SMALL se il buffer fornito è troppo piccolo per il blocco di dati, altrimenti il minidriver inserisce le impostazioni in un blocco di dati che può essere ripristinato in un secondo momento.
È responsabilità del minidriver aggiungere controlli di integrità dei dati ai dati, ad esempio un GUID univoco per indicare che il minidriver ha generato i dati, un controllo di ridondanza ciclico (CRC) e una lunghezza dell'intestazione.
I dati restituiti devono essere leggeri e contenere solo le informazioni necessarie per ricostruire le impostazioni correnti.
Le applicazioni useranno questa proprietà per undos multilivello, archiviate con i progetti e così via.
In una chiamata al set di proprietà:
Il minidriver deve verificare l'integrità dei dati e verificare che le dimensioni del blocco di dati siano al di sotto delle dimensioni massime dei dati, ad esempio rifiutare qualsiasi elemento su una determinata dimensione. Deve anche verificare il CRC e la lunghezza dell'intestazione. Il minidriver deve anche memorizzare nella cache tutte le modifiche da propagare per CODECAPI_CURRENTCHANGELIST.
Requisiti
intestazioni : dichiarate in ksmedia.h. Includere ksmedia.h.