CODECAPI_ALLSETTINGS

Egenskapen CODECAPI_ALLSETTINGS används för att skicka fram och tillbaka ett minidrivergenererat datablock.

Hämta	Ställ in	Mål	Egenskapsbeskrivningstyp	Egenskapsvärdetyp
Ja	Ja	Filtrera	KSPROPERTY	PVOID

Egenskapsvärdet (åtgärdsdata) är av typen PVOID, vilket är en pekare till en buffert i användarläge för det minidrivergenererade datablocket.

Kommentarer

På en egenskap får du anrop:

Om ett program anropar en egenskap med en buffert med noll längd måste minimejeln returnera STATUS_BUFFER_OVERFLOW och ange den nödvändiga buffertstorleken i fältet Irp->IoStatus.Information. Om längdbufferten inte är noll måste minimejseln returnera STATUS_BUFFER_TOO_SMALL om den angivna bufferten är för liten för datablocket, annars packar minimejseln inställningarna i ett datablock som kan återställas senare.

Det är minimejselns ansvar att lägga till dataintegritetskontroller i data, till exempel ett unikt GUID för att indikera att minimejeln genererade data, en cyklisk redundanskontroll (CRC) och en rubriklängd.

De data som returneras ska vara lätta och innehålla endast information som krävs för att rekonstruera de aktuella inställningarna.

Program använder den här egenskapen för ångra på flera nivåer, lagras med sina projekt och så vidare.

I ett egenskapsuppsättningsanrop:

Minimejseln måste verifiera dataintegriteten och kontrollera att datablockets storlek är under den maximala datastorleken (till exempel avvisa allt över en viss storlek). Den måste också verifiera CRC och sidhuvudlängden. Minimejseln måste också cachelagra alla ändringar som ska spridas för CODECAPI_CURRENTCHANGELIST.

Krav

Rubriker: deklarerad i ksmedia.h. Ta med ksmedia.h.

Se även

KSPROPERTY-

CODECAPI_CURRENTCHANGELIST