Streamkategorien

Der KsProxy-Filter unterstützt mehrere Arten von Datenstromkategorien. Die Tabellen in den folgenden Unterabschnitten beschreiben die verschiedenen Arten von Datenstromkategorien und die Datenformate, die den einzelnen Kategorietypen zugeordnet sind, sowie den erweiterten Größenwert der Kopfzeile, den ein Videoaufnahme-Minidriver pro Kategorie angeben soll.

Ein Stream-Videoaufnahme-Minidriver stellt Datenstromkategorie- und Inhaltsinformationen als Reaktion auf eine SRB_GET_STREAM_INFO Anforderung bereit. Der Minidriver gibt Informationen zu jeder Datenstromkategorie zurück, die in einer HW_STREAM_INFORMATION Struktur unterstützt wird.

Innerhalb der HW_STREAM_INFORMATION-Struktur ist ein StreamFormatsArray-Element , das über einen Eintrag für jedes eindeutige Datenformat verfügt, das der Minidriver für die angegebene Datenkategorie bereitstellt. Jeder StreamFormatsArray-Eintrag enthält Datenstromformatinformationen, einschließlich Bildeigenschaften wie Farbformat, Bittiefe, Zuschneiden und Skalierungsinformationen. Auch im StreamFormatsArray-Element enthalten ist der Bereich der Formate, die für die angegebene Datenstromkategorie verfügbar sind.

Für jede Videostreamkategorie gibt es entsprechende KSDATAFORMAT - und KSDATARANGE-Strukturen , die beim Beschreiben des Datenstroms in der HW_STREAM_INFORMATION-Struktur verwendet werden sollen. Die Strukturen, die Datenstromkategorien entsprechen, werden in den Tabellen in den folgenden Unterabschnitten aufgeführt.

Die GUID der Datenstromkategorie und die GUID des PIN-Namens für eine bestimmte Art von Videoaufnahmedatenstrom sind in der Regel identisch. Diese GUIDs werden in den Membern "Category " und "Name " der HW_STREAM_INFORMATION Struktur angegeben. Der einzige Fall, in dem diese GUIDs nicht übereinstimmen, ist, wenn eine bestimmte Datenstromkategorie mehrere Instanzen in einem Filter enthält. In diesem Fall sollten die Kategorie-GUIDs übereinstimmen, aber jedem Pin sollte eine eindeutige Pin-Name-GUID zugewiesen werden.

Die folgenden Unterabschnitte enthalten Informationen zu jeder der verschiedenen Videoaufnahmestreamkategorien. Die GUID der Datenstromkategorie und die Pin-Name-GUID werden beschrieben, ebenso wie die Strukturen, die zur Unterstützung der Kategorie verwendet werden sollen. Die erforderliche Unterstützung für Eigenschaftensätze wird auch für jede Kategorie aufgeführt. Die entsprechenden DirectShow-Typinformationen für den Benutzermodus werden ebenfalls zur Vereinfachung aufgeführt.