カスタムファイルタイプの登録

[アーティクル]
04/22/2010

ここでは、フィルタグラフマネージャがファイル名を指定してどのようにソースフィルタを見つけるかについて説明する。この機構を使い、独自のカスタムファイルタイプを登録できる。ファイルタイプが登録されると、アプリケーションが IGraphBuilder::RenderFile または IGraphBuilder::AddSourceFilter を呼び出すたびに、DirectShow は正しいソースフィルタを自動的にロードする。

特定のファイル名からソースフィルタを見つけるため、フィルタグラフマネージャは次の処理を順に行う。

同じプロトコルを探す (存在する場合)。
同じファイル拡張子を探す。
"チェックバイト" と呼ばれるファイル内のバイトの同じパターンを探す。

プロトコル

ftp、http などのプロトコル名は、次のような構造を持つ HKEY_CLASSES_ROOT キーの下に登録されている。

  HKEY_CLASSES_ROOT
    <protocol>
        Source Filter = <Source filter CLSID>
        Extensions
            <.ext1> = <Source filter CLSID>
            <.ext2> = <Source filter CLSID>

ファイル名にコロン (':') がある場合、フィルタグラフマネージャは ':' の前の部分をプロトコル名として使用しようとする。たとえば、名前が "myprot://myfile.ext" である場合、myprot という名前のレジストリキーを検索する。このキーが存在し、Extensions という名前のサブキーが含まれている場合、フィルタグラフマネージャはそのサブキー内でファイル拡張子に一致するエントリを検索する。キーの値は文字列形式の GUID でなければならない。たとえば、"{00000000-0000-0000-0000-000000000000}" である。フィルタグラフマネージャが Extensions サブキー内で何も見つけられない場合は、Source Filter という名前のサブキーを検索する。この値も文字列形式の GUID でなければならない。

フィルタグラフマネージャが一致する GUID を見つけた場合は、この値をソースフィルタの CLSID として使い、フィルタのロードを試みる。一致する値が見つからない場合は、ファイルソース (URL) フィルタを使う。このフィルタはファイル名を URL として扱う。

このアルゴリズムには 2 つの例外がある。

ドライブ文字を除外するため、1 文字の文字列はプロトコルと見なさない。
文字列が "file:" か "file://" である場合、プロトコルと見なさない。

ファイル拡張子

ファイル名にプロトコルがない場合、フィルタグラフマネージャはレジストリでキー HKEY_CLASSES_ROOT\Media Type\Extensions\.ext\ を持つエントリを探す。.ext はファイル拡張子である。このキーがある場合、値 Source Filter にはソースフィルタの CLSID が文字列形式で入っている。キーは、メジャータイプとサブタイプの GUID を示す Media Type および Subtype の値が入っていることもある。

チェックバイト

一部のファイルタイプは、ファイル内の特定のバイトオフセットで生じるビットの特定パターンにより識別できる。フィルタグラフマネージャはレジストリで次の形式を持つキーを探す。

HKEY_CLASSES_ROOT\MediaType\{major type}\{subtype}

ここで major type と subtype は、バイトストリームのメディアタイプを定義する GUID である。各キーは、1、2 ... のように名前が付いた 1 つ以上のサブキーがある。この値はチェックバイトを定義する。また、Source Filter という名前のサブキーがあり、ソースフィルタの CLSID を文字列形式で指定する。チェックバイトサブキーは、次のような 4 つの値の組が 1 つ以上入った文字列である。

offset**,cb,mask,**val

一致するファイルを探すため、フィルタグラフマネージャはバイト番号 offset からの cb バイトを読み取る。次に、mask の値に対してビットごとの AND を実行する。結果が val に等しい場合、ファイルはその 4 つの値の組の値に一致する。値 mask と val は 16 進数で示される。mask エントリが空である場合、長さ cb の 1 の文字列として扱われる。offset が負の値である場合は、ファイルの最後からのオフセットを示す。キーに一致させるためには、ファイルはすべてのサブキーにあるすべての 4 つの値の組に一致する必要がある。

たとえば、レジストリで HKCR\Media Type の下に次のキーがあると想定する。

{e436eb83-524f-11ce-9f53-0020af0ba770}
    {7364696D-0000-0010-8000-00AA00389B71}
        0                    "0,4,,52494646,8,4,,524D4944"
        1                    "0,4,,4D546864"
        Source Filter        "{E436EBB5-524F-11CE-9F53-0020AF0BA770}"

最初のキーはメジャータイプ MEDIATYPE_Stream に対応する。その下のサブキーはサブタイプ MEDIATYPE_Midi に対応する。Source Filter サブキーの値は、ファイルソース (非同期) フィルタの CLSID を示す CLSID_AsyncReader である。

各エントリは複数の 4 つの値の組を持てる。それらすべてが一致する必要がある。次の例では、ファイルの最初の 4 バイトは 0xAB、0xCD、0x12、0x34 でなければならない。また、ファイルの最後の 4 バイトは 0xAB、0xAB、0x00、0xAB でなければならない。

    0, 4, , ABCD1234,  -4, 4, , ABAB00AB

また、1 つのメディアタイプの下に複数のエントリが示されることもある。その場合、いずれか 1 つに一致すれば十分である。この方式では、代替マスクのセットを使える。たとえば、RIFF ヘッダーがあったりなかったりする .wav ファイルである。

注 : この方式は Microsoft® Win32® の GetClassFile 関数で使われるものに似ている。

ソースフィルタのロード

フィルタグラフマネージャがファイルに一致するソースフィルタを見つけたと想定すると、グラフにそのフィルタを追加し、フィルタに IFileSourceFilter インターフェイスを問い合わせ、IFileSourceFilter::Load を呼び出す。Load メソッドの引数は、レジストリから決められたように、ファイル名とメディアタイプである。

フィルタグラフマネージャがレジストリで何も見つけられない場合、デフォルトで非同期ファイルソースフィルタを使う。その場合、メディアタイプをMEDIATYPE_Stream、MEDIASUBTYPE_None に設定する。

カスタム ファイル タイプの登録

その他のリソース

カスタムファイルタイプの登録