7月20日 White Balanceが調節できないとか，APIに金を取るとか・・・うーん， なかなか決め手となるドライバがないな．Unixだと register に書き込むとこ ろまで raw1394_writeな感じで簡単に触れるのに・・・Windowsで1394のパケッ トやdcamのレジスタをいじるには一体どうしたらええねん！？ それに，そもそもWindowsのドライバの中身はどうなっとんねん！？ ・・・どうも，Windows は Linux のように小回りが 効かないし，内側が見えん ・・・ああ，やっぱりLinuxにしようか(21時20ぷん)・・・ いや，ここで引き返しては，「極めるVisual C++」を買った意味がないやんけ． やっぱこの夏でDirectShowを極めよう．ここはいっちょ自分でドライバを描くでー (21時21ぷん) 何を思ったかDDKをダウンロードしにいく(21時25ぷん) ・・・といってもdocumentを見てみると，ドライバを一から書けるとは到底思えん．うーん， 困った・・・(22時30ぷん) ん？よくみると sonydcam なるサンプルがあるやんか．これは使えそうやな．よ しまずは，サンプルをコンパイルしてみよう(23時00ぷん)． [キーワード] Windows2000 DDK (Driver Development Kits), WDM (Windows Driver Model), KS (Kernel Streaming), KSProxy, DirectShow, 1394 Trade Association IIDC 1394 Digital Camera Spec.

Windows DDK (Driver Development Kits) のインストール ダウンロード サンプルのビルド Window2000 WDM Driver 概要 1394-base VideoCapture Driver [sonydcam.sys] 概要 サンプルを眺める [src\wdm\videocap\1394dcam] 特に，CameraControlとVideoProcAmpに関しては CapProp.h : Device.c, CapProp.c の プロトタイプ宣言 DcamDef.h: レジスタ空間,プロパティの 構造体定義,フレームレート等の定義 (1394dcam spec.準拠) PropData.h: Device.c : レジスタのread/write(device.c) CapProp.c: プロパティのget/set を参照する．カメラspecificなパラメータは，DcamDef.h, PropData.h と CapProp.cで扱う．(DcamDef.h は古いspec準拠であるため多少変更が必 要．) VideoFormatに関しては StrmData.h を参照する． プロパティをいじる プロパティの追加 ホワイトバランス カスタムプロパティセットとインタフェース ビデオモードをいじる mode3 (640 x 480)でとりたい！ フレームレート

サンプルのビルド

1. スタート → プログラム → Development Kits → Windows 2000 DDK → Checked(もしくは Free) Build Environment を選択
2. cd %NTDDK%\src
3. build -cZ
4. 数十分待つ

User-mode driver と Kernel-mode driver

User-mode drivers

デバイス依存のWin32, MS-DOSアプリケーションや，他の protected subsystem's driver

Kernel-mode drivers

Windows NT excutiveの一部として動くdriver

Windows2000 driverといえば，Windows2000で動く全ての kernel-mode driverを指す．これは WDM とそれ以外に分けられる．
kernel-mode の driver には

Highest-level drivers

FAT, NTFS,CDFS File System Drivers(FSDs)

Intermediate drivers

PnP function/filter drivers
PnP software bus drivers (WDM driver はこれらのサブセット)

Lowest-level drivers

PnP hardware bus drivers
Legacy device drivers

WDM driver

• [目的] Windows98,2000でsource compatible
• kernel-mode driverである
• Intermediate-levelである
• 設計方針はへルプ参照
• WDM class/miniclass drivers (WDM minidrivers)のペアによって， コーディングを簡略化できる

Windows2000 I/O モデル

I/O Manager

kernel-mode のドライバにインタフェースを提供し，I/O リクエストを行 う．

I/O system services

I/O Manager が user-mode のsubsystem に提供するサービス群で， user-mode の subsytemはI/O system serviceを用いて I/O リクエストを行う．

IRP (I/O Request Packets)

I/O Manager が kernel-mode driver とやり取りするためのパケット．

Kernel Streaming (KS) driver

Filters

デバイスの機能をカプセル化

Pins

デバイス上の I/O チャネルを表す

Clocks

on-board clock への問い合わせ等を管理

Allocators

on-board memory などのマネジメント

• Properties
• Events
• Methods

Stream Class driver と Minidriver

ルーチン命名規則

Io----	I/O Manager Routines
Ke----	Kernel Routines
Rtl----	Run-time Library Routines
Ke----	Kernel Routines
Ke----	Kernel Routines

キーワード

• I/O ManagerとIRP (I/O Request Packet)
• KS driver → Stream Class driver + Video Capture Minidriver
• IRB (I/O Request Block ? )
• SRB (Stream Request Block)
• DriverEntry()[sonydcam.c] driverのmain関数．全てはここから始まる
• CSR (Control and Status Register)

DDKのドキュメントを読む限り，流れはとりあえず，こんな感じのようやけど． (図は合っているかどうかは分かりません．もしご存じの方で誤りに気づかれ ましたら，お知らせいただければ幸いです．)

KSPROPERTY

PropData.h

各プロパティについてアイテムを定義

1. LONG xxxDefault
   デフォルト値の定義
2. KSPROPERTY_STEPPING_LONG xxxRangeAndStep
   パラメタの範囲とステップ幅を定義
3. KSPROPERTY_MEMBERLIST xxxMemberList(今はKSPROPERTY_MEMBERLISTの配列である)
   xxxRangeAndStep, xxxDefaulをそれぞれメンバリストへッダ(KSPROPERTY_MEMBERSHEADER)として 追加
4. KSPROPERTY_VALUES xxxValues
   xxxMemberListを用いて値(Value)を定義
5. DEFINE_KSPROPERTY_ITEM
   xxxValueを用いて アイテム(Item)を定義

各プロパティセットについてプロパティテーブルを定義

プロパティテーブルをプロパティセットテーブルへ追加

Device.c, CapProp.c

青色は [DCamPkt.c]で用いられる関数．
AdapterGetProperty, AdapterSetProperty は DCamReceivePacket(pSRB) で 用いられる． SetPropertyValuesToRegistry,SetCurrentDevicePropertyValues, InitializePropertyArrayなどはドライバの初期化／終了時にレジストリの read/writeを行う(プロパティ値の保存)．

ドライバレベル

カスタムプロパティセットに対してGUIDを生成

// {49BFAC9A-947D-4c12-8A09-3619C28C692A}
IMPLEMENT_OLECREATE(<>, <>, 
0x49bfac9a, 0x947d, 0x4c12, 0x8a, 0x9, 0x36, 0x19, 0xc2, 0x8c, 0x69, 0x2a);

// {49BFAC9A-947D-4c12-8A09-3619C28C692A}
DEFINE_GUID(<>, 
0x49bfac9a, 0x947d, 0x4c12, 0x8a, 0x9, 0x36, 0x19, 0xc2, 0x8c, 0x69, 0x2a);

// {49BFAC9A-947D-4c12-8A09-3619C28C692A}
static const GUID <> = 
{ 0x49bfac9a, 0x947d, 0x4c12, { 0x8a, 0x9, 0x36, 0x19, 0xc2, 0x8c, 0x69, 0x2a } };

{49BFAC9A-947D-4c12-8A09-3619C28C692A}

今必要なのはレジストリフォーマット用です．

ドライバのプロパティセットに追加

user-modeにてカスタムCOMインタフェースを作成する

モード3 (640 x 480) でとりたい！

    //
    // Until we build the format table dynamically,
    // we need to hardcode this.
    //
    //  TI 1394 DCam supports all modes of video format 0 (uncompressed).
    //
//    if(RtlCompareMemory(pDevExt->pchVendorName, "TI", 2) == 2) 
        StreamInfo->NumberOfFormatArrayEntries = NUM_DCAM_STREAM_FORMATS;
//    else
//        StreamInfo->NumberOfFormatArrayEntries = 1;  // 320x240 UYVY

    StreamInfo->StreamFormatsArray = &DCAM_StreamFormats[0];

• Official Pageへ
• Profile Pageへ
• 研究関係へ