Průniky rozsahů dat v AVStreamu

Formát dat je jedna sada parametrů popisující určitý aspekt připojení. Například formát zvukových dat může specifikovat určitý formát zvuku s X vzorky za sekundu a Y bity na vzorek.

Oblast dat určuje posloupnost platných parametrů. Například rozsah zvukových dat může určit určitý formát zvuku u vzorků A-B za sekundu a bitů C-D na vzorek.

Minidriver poskytuje seznam oblastí dat, které podporuje pro konkrétní pin ve členu DataRanges odpovídající KSPIN_DESCRIPTOR struktury.

V AVStream mohou minidriveři zadat své vlastní obslužné rutiny průniku rozsahu dat poskytnutím ukazatele na rutinu zpětného volání poskytnutého minidriverem v členu IntersectHandlerKSPIN_DESCRIPTOR_EX. Pokud chcete, aby AVStream protínal rozsahy, nastavte tento člen na NULL. Informace o definování rutiny zpětného volání najdete v tématu AVStrMiniIntersectHandlerEx .

Pokud minidriver poskytuje obslužnou rutinu protínání, když je potřeba vytvořit průnik, minidriver obdrží dva rozsahy dat, které odpovídají hlavnímu typu, subformátu a specifikátoru. Kromě toho se požadované atributy rozsahů dat shodují.

Pokud se rozsahy protínají a je v parametru Data rutiny zpětného volání AVStrMiniIntersectHandlerEx k dispozici dostatek místa ve vyrovnávací paměti, rutina průniku zvolí formát v průniku a vrátí ho volajícímu ve vyrovnávací paměti, na kterou odkazuje Data.

Pokud se obě oblasti dat neprotínají, obslužná rutina vrátí STATUS_NO_MATCH.

Pokud minidriver zadal dispečink AVStrMiniPinSetDataFormat, AVStream zavolá tento dispečink, aby informoval minidriver, že AVStream nastavuje určitý formát na pinu. Poskytněte ukazatel na zpětnovolací rutinu AVStrMiniPinSetDataFormat v členovi SetDataFormat struktury KSPIN_DISPATCH. (Minidrivery, které jsou klienty třídy stream, přijímají SRB_SET_DATA_FORMAT místo AVStrMiniPinSetDataFormat.)

Minidriver může odmítnout navrhovaný formát vrácením STATUS_NO_MATCH z AVStrMiniPinSetDataFormat.

Kromě počátečního volání AVStrMiniPinSetDataFormat před vytvořením špendlíku může minidriver obdržet druhé volání AVStrMiniPinSetDataFormat těsně před přechodem špendlíku do stavu RUN. Pokud je váš klient třídy AVStream nebo stream minidriver pro zachycení videa a obdržíte takové oznámení, bude toto odeslání obsahovat skutečné parametry povrchu. Pokud je to možné, minidriver by neměl selhat tuto druhou změnu formátu. Nepředpokládejte, že dojde k druhému volání.

Minidriver by měl zaznamenávat data v libovolném formátu, který byl obsažen v posledním úspěšném odeslání AVStrMiniPinSetDataFormat .