Windows Driver Kit (WDK) Version 7.1.0 リリースノート

[アーティクル]
01/25/2016

Windows Driver Kit (WDK) Version 7.1.0 は、WDK 7.0.0 リリースの更新プログラムであり、ドライバー開発者が Windows 7、Windows Vista、Windows XP、Windows Server 2008 R2、Windows Server 2008、および Windows Server 2003 向けドライバーの作成に使用できるツール、コードサンプル、ドキュメント、コンパイラ、ヘッダー、およびライブラリのセットが含まれています。

WDK Version 7.1.0 の変更点と問題
RTM のリリースノート
[RTM Version 7.0.0] ライセンス情報
[RTM Version 7.0.0] インストール情報
[RTM Version 7.0.0] WDK ビルド環境の変更点と問題
[RTM Version 7.0.0] 再頒布可能な変更点と問題
[RTM Version 7.0.0] サンプルの変更点と問題
[RTM Version 7.0.0] ポータブルデバイス (WPD) ドライバーサンプルのメモリリーク
[RTM Version 7.0.0] ツールの変更点と問題
2009 年 8 月リリースノート
[2009 年 8 月] 間違ったデバイス ID が WPDMultiTransportDriver のインストール手順で指定される
[2009 年 8 月] 64 ビットでの、整数から浮動小数点数への変換により、コンパイラに問題が発生する可能性がある
[2009 年 8 月] Unicode 書式設定関数および解析関数
[2009 年 8 月] WttLogCm.dll が WDTF の WDK インストールに含まれていない
関連トピック

WDK Version 7.1.0 の変更点と問題

このセクションには、7.1.0 更新リリースでの WDK の変更点に関する情報が含まれています。

Windows XP x64 をインストールプラットフォームとしてサポート

デバッガーの変更点

WDK のこのリリースでは、Debugging Tools for Windows が更新されています。次のように変更されました。

デバッガーのバージョンが 6.12.2.633 に変更されました。詳細については、デバッガーパッケージのリリースノートをご覧ください。
ndiskd.dll の更新
UMDF と KMDF のデバッガー拡張機能でのその他のバグ修正:
- KMDF
  - キューで 50 個を超える要求を印刷可能
  - !wdfdevice が FileObjectClass 名を正しく表示
  - ドライバーの通知一覧にある場合は、要求が取り消されたかどうかを表示
- UMDF
  - umirps の取り消しのコールバックを正しく表示
  - デバイスのクリーンアップコールバックと閉じるコールバックをダンプ
  - 要求に関連付けられたファイルオブジェクトを表示

再頒布可能な変更: offreg.dll への更新

ビルド環境の変更

MSVCRT.lib の更新による、Vista での DLL または EXE のクラッシュの修正
ws2_32.lib の更新
ntddump.h の追加
NPIV.mof の追加
Vista 7ip のヘッダーの追加
I/O ルーチンの注釈の修正
すべての umdf トレース GUID を含む wudftrace.ctl の追加

サンプルの変更点と問題

NDIS:
- Xframeii: バグの修正
- NetVmini サンプルの追加
センサーのスケルトンサンプル: メモリリークの問題の修正
KMDF Toaster サンプル: バグの修正
WDM イベントのサンプル: バグの修正
ポート I/O のサンプルドライバー: ファイル …\src\general\portio\sys\genport.inx に構文の問題があり、Windows 7 より前のシステムにはドライバーが正常にインストールされません。"PORTIO_Device" のすべてのインスタンスを "PortIO_Inst" に置き換えると、この問題を回避できます。

センサーアダプターテストスイートの更新

RTM のリリースノート

[RTM Version 7.0.0] ライセンス情報

[RTM Version 7.0.0] ソフトウェアライセンス条項

Windows Driver Kit (WDK) に含まれるコンテンツは、ライセンスがエンドユーザーに供与されています。WDK の使用は、WDK に付随し、WDK のインストールディレクトリにあるソフトウェアライセンス条項 (EULA) に基づきます。ファイルの名前は License.rtf です。WDK にアクセスまたは使用する前に、EULA の条項を読み、同意する必要があります。EULA の条項に同意しない場合、WDK を使用することはできません。

[RTM Version 7.0.0] Active Perl

Windows Driver Kit (WDK) には、Active Perl が含まれます。ActiveState Corporation の Active Perl の詳細については、の Web サイトを参照してください。

[RTM Version 7.0.0] インストール情報

WDK のインストールに関するすべての情報についてはインストールガイドをご覧ください。

[RTM Version 7.0.0] インストール情報

[RTM Version 7.0.0] IA64 はインストールプラットフォームとしてサポートされていない

[RTM Version 7.0.0] デバッガーのインストール

Kitsetup を使って Windows デバッガーをインストールした場合は、選んだインストールパスにある Debuggers という名前のフォルダーにデバッガーツールがインストールされます。その他の WDK コンポーネントと共にデバッガーツールをインストールした場合は、それらのルートインストールパスがすべて同じになります。その他の WDK コンポーネントとは別のルートパスにデバッガーツールをインストールする場合は、次の操作のいずれかを行います。

デバッガー MSI を直接、メディアで実行します。
Kitsetup を実行し、デバッガーのみをインストールします。次に、デバッガーのインストールパスを選びます。その他の WDK コンポーネントをインストールするために Kitsetup をもう一度実行し、その他の WDK コンポーネント用に別のインストールパスを選びます。

[RTM Version 7.0.0] Mc.exe ツールを実行するために MSXML 6.0 が必要

メッセージコンパイラ (Mc.exe) ツールが正しく動作するためには、Microsoft Core XML Services (MSXML) 6.0 が必要です。Windows XP Service Pack 3 以降のバージョンの Windows に Windows Driver Kit (WDK) がインストールされている場合は、MSXML 6.0 が既にインストールされています。それより前のバージョンの Windows オペレーティングシステムに Windows Driver Kit (WDK) がインストールされている場合は、MSXML 6.0 をダウンロードしてください。MSXML 6.0 サービスをダウンロードするには、Microsoft ダウンロードセンター Web サイトにアクセスします。

[RTM Version 7.0.0] キットコンテンツのレイアウト

既定では、WDK が、ローカルディスクの次の場所にインストールされます。この WDK の既定のインストールパスは C:\WinDDK\7600.0.0 です。

ディレクトリ	コンテンツ
\Bin	WDK ビルドツール
\Debug	デバッグ時に使用するファイル
\Help	WDK ドキュメント
\Inc	WDK ヘッダー
\Lib	インポートライブラリ
\OACR	Microsoft Auto Code Review
\Redist	再頒布可能ファイル
\Src	WDK サンプル
\Tools	開発、デバッグ、およびテスト用の各ツール
\Debuggers	Windows デバッガー

[RTM Version 7.0.0] Vista RTM で考えられる WinUSB のインストールの問題

問題: サービスパックがインストールされていない Windows Vista でインストールが失敗する場合があり、WinUSB2 のインストール時にデバイスが機能しません。

回避策: この問題を回避するには、Microsoft サポート技術情報の修正プログラム 949939 および 937287 をインストールするか、Vista Service Pack 1 (SP1) または Vista SP2 にシステムを更新します。

[RTM Version 7.0.0] WDK ビルド環境の変更点と問題

このセクションには、WDK for Server 2008 (6001.18002) 以降にビルド環境に加えられた変更に関する情報が含まれています。

[RTM Version 7.0.0] Windows 2000 ビルド環境のサポート停止

Microsoft Windows 2000 のライブラリが WDK から削除されました。_NT_Target_Version=$ (NT_TARGET_VERSION_WIN2K) の場合はエラーになります。_NT_Target_Version は、Windows XP 以降のバージョンの Windows である必要があります。

[RTM Version 7.0.0] KMDF バージョンと UMDF バージョンのマクロの変更

KMDF バージョンと UMDF バージョンを示すマクロの構文が変更されました。Windows 7 では、以前の構文を使うと警告が表示されます。

KMDF_VERSION_ は KMDF_VERSION に変更
UMDF_VERSION_ は UMDF_VERSION_MAJOR に変更
KMDF_MINOR_VERSION_ は KMDF_VERSION_MINOR に変更
UMDF_MINOR_VERSION_ は UMDF_VERSION_MINOR に変更

[RTM Version 7.0.0] Microsoft Auto Code Review (OACR) の追加

Microsoft Auto Code Review (OACR) ツールが WDK ビルド環境に追加されました。WDK ビルド環境ウィンドウを開くと、自動的に OACR が起動します。これは、バックグラウンドで実行され、ビルドが終了するたびに PreFast for Drivers (PFD) を実行します。タスクバーのアイコンで、ビルドに PFD のエラーと警告が含まれているかどうかが示されます。OACR について詳しくは、WDK ドキュメントをご覧ください。

[RTM Version 7.0.0] コード署名ツールの変更 Signtool は、次の変更で更新されました。

CAPICOM に依存しなくなった
SHA-2 ダイジェストアルゴリズムの署名での使用をサポート
Windows 7 で使った場合の RFC 3161 タイムスタンプをサポート
/ac スイッチと /kp スイッチを修正

[RTM Version 7.0.0] ATL 2.1 ヘッダーと ATL 3.0 ヘッダーを削除

ATL 2.1 ヘッダーと ATL 3.0 ヘッダーが削除されました。ATL 7.1 ヘッダーを、…\inc\crt\atl71 から …\inc\atl71 に移動しました。ビルド環境が変更されて、新しい位置で ATL 7.1 ヘッダーファイルが使われるようになりました。Sources ファイルに ATL_VER が含まれている場合は、値が 70 または 71 となります。

[RTM Version 7.0.0] ヘッダーファイルの追加と削除

次のヘッダーは、WDK for Server 2008 (6001.18002) に含まれていましたが、このリリースには含まれていません。

DDK:

Fsctlbuf.h
Hvgdk.h
Rdbss.h
Rxassert.h
Rxcommon.h
Rxdebug.h
Rxpooltg.h
Smbus.h

API:

Dmmdiag.h
Specstrings_adt.h
Wincred.h

Wincred.h 次の DDK ヘッダーファイルが WDK に追加されました。

DDK:

Anchorsyncdeviceservice.h
Bridgedeviceservice.h
Calendardeviceservice.h
Cifs.h
Contactdeviceservice.h
Deviceservices.h
Dsm.h
Fullenumsyncdeviceservice.h
Hintsdeviceservice.h
Messagedeviceservice.h
Metadatadeviceservice.h
Mpiodisk.h
Mpiowmi.h
Ndischimney.h
Ndiswwan.h
Notesdeviceservice.h
Offreg.h
Procgrp.h
Ringtonedeviceservice.h
Sensorsclassextension.h
Statusdeviceservice.h
Syncdeviceservice.h
Taskdeviceservice.h
Usbstorioctl.h
Wwan.h
Xpsrassvc.h

API:

Audioapotypes.h
Audioendpoints.h
Audioendpoints.idl
D3d11tokenizedprogramformat.hpp
Dxgiformat.h
Functiondiscoveryerror.h
Functiondiscoveryprovider.h
Functiondiscoveryprovider.idl
Functiondiscoveryproviderhelper.h
Fwpvi.h
Hvgdk.h
Ime_cmodes.h
Kernelspecs.h
Lsalookup.h
Lsalookupi.h
Mmc.h
Mshtmhst.h
Mshtml.h
Msopc.h
Mxdc.h
Objectarray.h
Objectarray.idl
Pbdaerrors.h
Pmi.h
Qosobjs.h
Sal_supp.h
Sdv_driverspecs.h
Sensors.h
Specstrings_supp.h
Structuredquerycondition.h
Structuredquerycondition.idl
Usbrpmif.h
Verrsrc.h
Winbio.h
Winbio_adapter.h
Winbio_err.h
Winbio_ioctl.h
Winbio_types.h
Wnnc.h
Xpsobjectmodel.h

[RTM Version 7.0.0] KMDF/UMDF Version 1.9

KMDF と UMDF が、バージョン 1.9 に更新されました。次の変更点があります。

KMDF ドライバーの進捗を保証
KMDF でのパフォーマンスの向上
UMDF ホストプロセスのセキュリティの強化
UMDF プラグアンドプレイ (PnP) モデルの機能強化
ユーザーモードスタックでカーネルモードドライバーが使用可能

KMDF では、Windows 2000 以降のシステムでの動作も、引き続きサポートされています。UMDF では、Windows XP 以降のシステムでの動作がサポートされています。詳細については、WDK ドキュメントを参照してください。

[RTM Version 7.0.0] HID デバイス用 KMDF フィルタードライバーが I/O を送信できない場合がある

問題: フィルタードライバーで、WDFIOTARGET オブジェクトで使われ、デバイスの起動前に作成される I/O の種類の情報が、iotarget オブジェクトで表されるターゲットデバイスオブジェクトの I/O の種類の情報と一致しない場合があります。その結果、フィルタードライバーが要求をフォーマットするときに、ベースとなる IRP が正しくフォーマットされない場合があります。現時点では、問題が発生するのは、フィルタードライバーが HID デバイス用に使用されている場合のみです。これは、IRP_MN_START_DEVICE 処理中に、HIDClass のデバイス (PDO) の I/O の種類が変更されるためです。この問題は、既定の I/O のターゲットと、EvtDriverDeviceAdd コールバックのドライバーによって作成される他の WDFIOTARGET のオブジェクトに影響します。

回避策: この問題を回避するには、より下位のデバイスオブジェクトへの EvtDriverDeviceAdd() コールバックの代わりに、EvtDeviceSelfManagedIoInit() コールバックに I/O のターゲットを作成し、使用します。次のサンプルコードが用意されています。

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE(&openParams, WdfDeviceWdmGetAttachedDevice (device)); 
status = WdfIoTargetCreate(device, WDF_NO_OBJECT_ATTRIBUTES, &devExt->IoTarget); 
status = WdfIoTargetOpen(devExt->IoTarget, &openParams);

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE(&openParams, WdfDeviceWdmGetAttachedDevice (device)); status = WdfIoTargetCreate(device, WDF_NO_OBJECT_ATTRIBUTES, &devExt->IoTarget); status = WdfIoTargetOpen(devExt->IoTarget, &openParams);

[RTM Version 7.0.0] 再頒布可能な変更点と問題

このセクションには、WDK for Server 2008 (6001.18002) 以降に再頒布可能ファイルに加えられた変更に関する情報が含まれています。

[RTM Version 7.0.0 WDF] 共同インストーラー

WDF Version 1.9 の共同インストーラーが含まれます。WDF Version 1.7 の共同インストーラーは削除されました。WDF 1.9 共同インストーラーは、WDF の以前のバージョンとの下位互換性があります。

[RTM Version 7.0.0] WinUSB 共同インストーラー

WinUSB v2 の共同インストーラーがキットに追加されました。

[RTM Version 7.0.0] DIFx

DIFx 再頒布可能ファイルが更新されました。

[RTM Version 7.0.0] Offreg

Offreg DLL が追加されました。

[RTM Version 7.0.0] サンプルの変更点と問題

このセクションには、WDK for Server 2008 (6001.18002) 以降にサンプルに加えられた変更に関する情報が含まれています。

[RTM Version 7.0.0] フォルダーの再編成のサンプル

サンプルが再編成されました。KMDF と UMDF のサンプルを、適切なデバイス領域のフォルダーに移動しました。WDM サンプルの一部が削除されました。WDK に残されているものは、同じ場所にあります。

[RTM Version 7.0.0] 署名のサンプル

署名のサンプル、Selfsign_example.cmd を、…\bin\selfsign から …\src\general\build\driversigning に移動しました。

[RTM Version 7.0.0] サンプルの追加と削除

次のサンプルは、WDK for Server 2008 (6001.18002) に含まれていましたが、このリリースには含まれていません。

HID: 仮想 HID (Vhidmini.sys)
ファイルシステム:
- Filespy フィルター
- Mulnrx
- Smbmrx
PnPI8042
Mouser
カーネルサンプル:
- AGP440
- AGPlib
- GAGP30KX
- Radeon 8500
- サンプルドライバー
- UAGP35
MCA 管理アプリケーション
ネットワーク:
- COISDN
- IRDA
- E100BEX
- NDIS コネクションレスプロトコルドライバー
ストレージ:
- チェンジャー INF のサンプル
- テープのサンプル
- I2O ミニポート
ビデオ: R200 のサンプル

次のサンプルが WDK に追加されました。

1394: ハイブリッド (UMDF/KMDF) 1394VDEV ドライバー
オーディオ: Mic 配列
生体認証のサンプル
Build.exe のサンプル
バス:
- UMDF の仮想シリアルドライバー
- 連続的なリーダーと電源ポリシー所有者を示すように、UMDF USB Fx2 のサンプルを更新
ファイルシステム: Simrep ミニフィルター
全般:
- パフォーマンスカウンター
- RegFltr
- KMDF に変換された PortIO サンプル
- Toastmon ドライバーの UMDF バージョン
- トースター関数ドライバーの UMDF バージョン
HID: EloMT
入力: KMDF に変換された Moufilter ドライバー
ネットワーク: Xframe II
印刷: XPS ラスターフィルター
センサーのサンプル
ストレージ: Storport ミニポート
WMI のサンプル
WPD:
- WPD 基本ハードウェアドライバー
- WPD MultiTransport ドライバー
- WPD サービスサンプルドライバー

これらのサンプルに関する追加情報は、WDK ドキュメント、またはサンプルに付属するディレクトリのファイルにあります。

[RTM Version 7.0.0] SWTuner のサンプル

SWTuner のサンプルでは、次の種類のデジタル通信網がサポートされています。

ATSC
QAM
DVB-T
DVB-S
DVB-C
ISDB-T
ISDB-S
Netop

主な相違点は復調器ノードの種類です。これで、現在使用している標準が特定されます。フレームワークでは、KS プロキシの必要な BDA 定義をすべて公開して、チューナーと復調器のパラメーターを制御します。ただし、SWTuner は、周波数だけを内部的に処理して、HDD からストリーミングされるトランスポートストリームを選択します。PAL/Secam チューナーの機能強化により、アナログテレビの包括的なスキャンの実装方法が示されます。チューナーハードウェアベースのスキャンを有効にするために、レジストリキー HardwareScanning=1 を設定する必要があります。サンプルは、低い周波数から高い周波数へと 250khz ごとにスキャンするスキャンスレッドを設定する方法を示しています。アナログフレームワークは、フィルターチューナー、オーディオ、クロスバー、キャプチャ、エンコーダーを公開します。DVB-S の機能強化により、チューニングに DiSEqC を実装する方法が示されます。

PBDA インターフェイスは、DVB-S のサンプル用に組み込まれています。これは、イベント処理や MMI など、PBDA インターフェイスで BDA チューナーを強化する方法を説明しています。

また、Netop という種類のチューナーは PBDA スキーマ全体を使用し、次のサービスなど、使用可能なすべての PBDA インターフェイスを実装します。Netop チューナーは、GPNV 値 Source Types の DVB-T ネットワークという種類として調整されます。

イベント処理サービス:

PBDA ユーザーモード ESEvents へのキューに入れられたイベントの転送を処理するイベント処理マネージャー。

デバッグサービス:

ユーザーモードへのデバッグメッセージのキューの管理。

GPNV サービス:

操作、セットアップ、MMI の基本的な使用方法を示す必要な Name 値の実装。実際のチューナーでは、変数 Device ID と Tuner ID が設定されず、代わりに、チューナーの固定値が保存されます。

CAS サービス:

実装では、診断とセットアップのページでの MMI の使用方法が示されます。ブロードキャスト MMI が、チャネルの変更で示されます。

MUX サービス:

サービス転送 PID マッピング情報。これにより、トランスポートストリームマッピングを制御し、現在選択されているサービスを識別することができます。PBDA チューナーは、それ自体のデマルチプレクサーを制御し、すべての PID を出力トランスポートストリームにマップすることができます (ハードウェアが完全な mpeg2 トランスポートストリームを配信できない場合)。

DRM サービス:

すべての DRM 関連関数のエントリポイント。

スキャン/チューニング:

周波数の範囲のスキャンと、xml チューニングパラメーターによるチューニングパラメーターの設定/取得。チューナーは、低い周波数から高い周波数へのスキャンを使って変調パラメーターを決定できます。これらのパラメーターは、チューナーが PBDA_Tuning_GetTunerState を使って信号を検出するたびに読み取られます。

GDDS:

PBDA サービスと、そのチューニングパラメーター、インターフェイスを読み込んで、ガイドデータを読み込みます。データ型が PBDA_GUIDE_DATATYPE の場合にのみ、サービスとガイドデータが GDDS を使って読み込まれることに注意してください。それ以外の場合はすべて、帯域内トランスポートストリームデータによって、サービスとガイドデータが決まります。

UserActivity:

この PBDA サービスのインターフェイス

[RTM Version 7.0.0] ポータブルデバイス (WPD) ドライバーサンプルのメモリリーク

問題: 次のアプリケーションシナリオでは、ドライバーでメモリリークが発生します。その結果、ドライバーのシャットダウンまで、メモリの使用量が WUDFHost.exe プロセスで蓄積されます。

このようなリークを修正するには、回避策のセクションの説明に従って、ドライバーサンプルコードを更新してください。

オブジェクトの列挙時に、列挙子のコンテキストが WpdObjectEnumerator::OnFindNext で解放されません。影響: WpdHelloWorldDriver、WpdMultiTransportDriver、WpdBasicHardwareDriver、WpdServicesSampleDriver
オブジェクトの削除時に、ダミーのコンテンツオブジェクトのデストラクターが、m_Content 配列からの参照を削除する前に呼び出されません。影響: WpdWudfSampleDriver
WpdObjectResources::OnClose で、リソースコンテキストへの追加の参照が解放されません。影響: WpdWudfSampleDriver

回避策:

WpdObjectEnum.cpp では、WpdObjectEnumerator::OnFindNext() の前の SAFE_RELEASE pEnumeratorContext が返されます。

例:
```
SAFE_RELEASE(pEnumeratorContext); 
return hr;
```

WpdWudfSampleDriver\FakeDevice.h、RemoveObjectsMarkedForDeletion() では、m_Content 配列からの参照を削除する前に FakeContent オブジェクトを削除します。

例:

if (m_Content[Index - 1]->MarkedForDeletion == TRUE) 
{ 
    // Delete this object 
    FakeContent* pContent = m_Content[Index - 1]; 
    m_Content.RemoveAt(Index - 1); 
    delete pContent;
}

WpdWudfSampleDriver\WpdObjectResources.cpp では、WpdObjectResources::OnClose() の前の SAFE_RELEASE pContext が返されます。

例:
```
//Free the context 
SAFE_RELEASE(pContext); 
if (hr == S_OK) 
{ 
    hr = DestroyResourceContext(pContextMap, pszContext);
    ...
}
```

[RTM Version 7.0.0] DSF: ループバックのサンプルのバルクエンドポイントが正しく構成されていない

問題: USB 2.0 仕様により、バルクエンドポイントには、512 バイトの最大パケットサイズを設定できます。DSF ループバックサンプルのバルクエンドポイントのエンドポイント記述子が、誤って 1024 バイトに構成されています。

回避策: src/test/dsf/usb/softusbloopback/LoopbackDevice.cpp の CLoopbackDevice::ConfigureINEndpoint と ConfigureOUTEndpoint で、最大パケットサイズが 512 バイトのバルクエンドポイントとしてエンドポイント記述子を設定し、サンプルを再コンパイルします。

[RTM Version 7.0.0] センサードライバーサンプルのメモリリーク

問題: センサーのサンプル (センサーのスケルトンと時間センサーの両方) でメモリリークが発生します。このリークは、コンピューターの起動時に、ドライバープロセス (WUDFHost.exe) ごとに 1 回発生します。このようなリークを修正するには、回避策のセクションの説明に従って、ドライバーサンプルコードを更新してください。

注:

センサーのスケルトンのサンプルでは、次の回避策をすべて実行する必要があります。
時間センサーのサンプルに必要なのは、最初の 2 つの回避策だけです。

回避策:

Device.cpp では、CMyDevice::CreateInstance の前の SAFE_RELEASE pMyDevice が返されます。

CComPtr<IWDFDevice> spIWDFDevice; 
if (SUCCEEDED(hr)) 
{ 
    // Create the IWDFDevice object 
    hr = pDriver->CreateDevice(pDeviceInit, spCallback, &spIWDFDevice);
 } 
// Release the pMyDevice pointer when done. Note: UMDF holds a reference to it above 
SAFE_RELEASE(pMyDevice);

Queue.cpp では、CMyQueue::CreateInstance の前の SAFE_RELEASE pMyQueue が返されます。

// Create the framework queue 
CComPtr<IWDFIoQueue> spDefaultQueue; 
hr = pWdfDevice->CreateIoQueue( spIUnknown, 
                                TRUE,                       // DefaultQueue 
                                WdfIoQueueDispatchParallel, // Parallel queue handling 
                                FALSE,                      // PowerManaged 
                                TRUE,                       // AllowZeroLengthRequests 
                                &spDefaultQueue 
                                ); 
// Release the pMyQueue pointer when done. Note: UMDF holds a reference to it above 
SAFE_RELEASE(pMyQueue);

Device.cpp では、CMyDevice::OnPrepareHardware の前の SAFE_RELEASE pSensorDdi が返されます。

if (SUCCEEDED(hr)) 
{ 
    hr = m_pClassExtension->Initialize(pWdfDevice, spUnknown); 
} 
// Release the pSensorDdi pointer when done. Note: Sensor Class Extension holds a reference to it above SAFE_RELEASE(pSensorDdi);

[RTM Version 7.0.0] ツールの変更点と問題

このセクションには、WDK for Server 2008 (6001.18002) 以降にツールに加えられた変更に関する情報が含まれています。

[RTM Version 7.0.0] ツールの追加と削除

次のツールは、WDK for Server 2008 (6001.18002) に含まれていましたが、このリリースには含まれていません。

Rpat.exe
AMCap2.exe
MCStream.exe
Nxdemo.exe

WDK には次のツールが追加されました。

生体認証 – Biotest.exe、WBDIDriverTest.exe
Bluetooth – Sdpverify.exe
Driver Coverage – Drvcov.exe
拡張ストレージ – EhStorCertMgrCmd.exe
テストツール – IOSpyCmd.exe、IOAttack.exe
ネットワーク – WwanDriverTestApp.exe
汎用 – ComputerHardwareIds.exe
印刷 – XpsAnalyzer.exe

これらのツールの使用方法に関する追加情報は、WDK ドキュメントで確認できます。

[RTM Version 7.0.0] PFD の機能強化

PFD は、次のように機能強化されました。

PFD では、より広い範囲の式の分析がサポートされています。例: Const、メンバー名、"副作用のない" C 式。
注釈エラーチェック機能の向上。
"禁止された API" を含む欠陥検出機能の向上。
PFD で警告が生成されるようになり、静的ドライバー検証ツールによるドライバーの分析に役立ちます。SDV には、ドライバーの宣言が必要です。この宣言で、ドライバーが提供するコールバック関数の役割が定義されます。PFD は、これらの役割型の宣言をドライバーコードに追加することが必要になるタイミングを示します。

[RTM Version 7.0.0] 静的ドライバー検証ツールの機能強化

静的ドライバー検証ツールは、次のように機能が強化されています。

NDIS ミニポートドライバーの DV サポート。
WDM および KMDF の拡張された規則セット。
役割型の宣言。
ドライバープロパティの規則。
エントリごとの検証。
パフォーマンス、スケーラビリティ、精度の向上。

[RTM Version 7.0.0] 検証中のアクセス許可拒否の例外によりツールエラーが発生する

問題: ウイルス対策プログラムが実行中で、ドライバーのソースコードディレクトリが実行時のスキャンから除外されていない場合は、SDV で "Sys_error (slam.bp: Permission denied)" 例外により検証が中止されることが稀にあります。

回避策: ドライバーのソースコードのソースツリーの同時アクセスを無効にします。たとえば、ウイルス対策プログラムの除外ディレクトリの一覧にドライバー検証パスを追加します。

[RTM Version 7.0.0] 静的ドライバー検証: トラブルシューティングに関する推奨事項

問題: 静的ドライバー検証ツール (SDV) をドライバーソースコードで実行しているときに SDV で Timeout、GiveUp、Spaceout が報告されます。

回避策: 静的ドライバー検証ツール (SDV) で Timeout、GiveUp、または Spaceout が報告される場合は、次の操作を実行します。

/refine コマンドオプションを使って SDV を実行します。たとえば、「staticdv /refine /rule:*」と入力します。SDV で実行中に NUR の結果が見つかった場合は、コンソールで使われる正確なコマンドラインがシアン色で生成されることに注意してください。このコマンドラインには、refine.sdv という名前の構成ファイルへの参照が含まれます。このファイルは、NUR を報告するすべての規則の一覧です。コマンドラインは、"Staticdv /config:"refine.sdv" /refine" のようになります。次の 2 つの推奨事項では、オプションファイル、sdv-defaults.xml の変更が必要です。既定のファイルはドライバーモデルに固有で、\tools\sdv\data\model\ ディレクトリにあります。ここで、model は、WDM、WDF、または NDIS です。
コンピューターがマルチコアプロセッサを搭載している場合は、検証中に使うスレッドの数を 1 に減らしてください。SDV の既定のファイルで、SDV_SlamConfig_NumberOfTheads の値を 1 に変更します。
SDV で Timeout が報告される場合は、タイムアウト制限の値を増やします。たとえば、SDV_SlamConfig_Timeout の値を 2 倍 (4000) に増やします。
これらの方法を単独で適用しても効果がない場合は、すべてを組み合わせて使用してください。これらの方法により、実際の実行時間が長くなることに注意してください。ただし、SDV がジョブを完了しやすくなり、有用な結果 (Pass または Defect) が得られます。

2009 年 8 月リリースノート

[2009 年 8 月] センサードライバーのデータフィールドで間違ったデータ型が使われる

問題: センサーのスケルトンのサンプルで、次のプロパティに間違ったデータ型が使われます。 SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS 正しいデータ型は、Float (VT_R4) ではなく、Double (VT_R8) です。

回避策: CSensorDDI::InitializeGpsSensor のコードを次のコードに置き換えます。

// Altitude Value 
var.vt = VT_R8; 
var.dblVal = ALTITUDE_VALUE_METERS; 
m_pGpsSensorDataFieldValues->SetValue(SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS, &var);

[2009 年 8 月] ATL のベストプラクティス - Visual Studio リリースの使用

ATL が WDK に含まれているのは、ドライバー用の Windows アプレットを作る必要があるドライバー開発者の利便性のためです。ATL は、この範囲を超えるソフトウェア開発に使うことはできません。Visual Studio で使用できる ATL には、より完全で最新のライブラリのセットが用意されていますが、これは、ソフトウェアや Web アプリケーションの開発に使うためです。 Visual C++ Express Edition は、MSDN から無料で入手できます。

[2009 年 8 月] Windows ポータブルデバイスのサンプルのビルド環境と対象オペレーティングシステムの更新

ビルド環境と対象オペレーティングシステムの設定は、Windows ポータブルデバイスのサンプルでは不完全です。完全な一覧については、次のセクションを参照してください。

サンプル名: 包括的な WPD サンプルドライバー

ビルド環境:

Windows XP (x86)
Windows Vista (x86、amd64)
Windows 7 (x86、amd64)

対象オペレーティングシステム:

Windows XP (x86)
Windows Vista (x86、amd64)
Windows 7 (x86、amd64)

サンプル名: Windows ポータブルデバイスの Hello World ドライバー

ビルド環境:

Windows XP (x86)
Windows Vista (x86、amd64)
Windows 7 (x86、amd64)

対象オペレーティングシステム:

Windows XP (x86)
Windows Vista (x86、amd64)
Windows 7 (x86、amd64)

サンプル名: Windows ポータブルデバイスの基本ハードウェアドライバー

ビルド環境:

Windows XP (x86)
Windows Vista (x86、amd64)
Windows 7 (x86、amd64)

対象オペレーティングシステム:

Windows XP (x86)
Windows Vista (x86、amd64)
Windows 7 (x86、amd64)

サンプル名: Windows ポータブルデバイスのマルチトランスポートドライバー

ビルド環境:

Windows 7 (x86、amd64)

対象オペレーティングシステム:

Windows 7 (x86、amd64)

サンプル名: Windows ポータブルデバイスの基本サービスサンプルドライバー

ビルド環境:

Windows 7 (x86、amd64)

対象オペレーティングシステム:

Windows 7 (x86、amd64)

Windows XP の場合の追加要件: Windows ポータブルデバイスのバイナリは Windows XP に含まれていません。ドライバー (Windows XP 用にビルドされた) の読み込みを有効にするために、Windows Media Format SDK 11 ランタイムをインストールする必要があります。

[2009 年 8 月] 間違ったデバイス ID が WPDMultiTransportDriver のインストール手順で指定される

問題: Devcon.exe のコマンドラインに指定されるデバイス ID が、Windows ポータブルデバイスのマルチトランスポートドライバーに対しては間違っています。その結果、WpdMultiTransportDriver が正しくインストールされません。ドライバーを正しくインストールするには、更新された次の手順に従います。

回避策: インストール手順 (修正されたデバイス ID が強調表示されている) は次のとおりです。

[スタート] メニューから目的のビルド環境を起動します。
サンプル ("build –cZ") をビルドします。
ドライバーの DLL を含むディレクトリに WUDFUpdate_0xxxx.dll をコピーします。
ドライバーをインストールします ("devcon install Wpdmultitransportdriver.inf")。

[2009 年 8 月] 64 ビットでの、整数から浮動小数点数への変換により、コンパイラに問題が発生する可能性がある

問題: WDK に含まれている 64 ビットコンパイラは、浮動小数点数から整数への最適化された変換の実行時に、無効なアセンブリを生成する可能性があります。生成されたアセンブリには、この手順でサポートされていないソース登録を使う手順が含まれています。この問題がコードに存在するかどうかを判断するには、次の手順を実行してください。

ソースコードを /FAsc オプションでコンパイルしてコンパイラの一覧 (既定では .cod ファイル) を生成します。
一覧をフィルター処理して、CVTTSD2SI、CVTTSS2SI、VCVTTSD2SI、VCVTTSS2SI の各手順をすべて抽出します。
DUMPBIN ツールを使って、DUMPBIN /DISASM バイナリファイルのようなバイナリを逆アセンブルします。
この出力をフィルター処理して、CVTTSD2SI、CVTTSS2SI、VCVTTSD2SI、VCVTTSS2SI をすべて抽出します。
コンパイラの一覧からの変換手順と、逆アセンブリからの変換手順を比較します。違いがある場合は、この変換のためにコンパイラが生成した手順は間違っています。

回避策: オプション 1: プラグマのペアを使って、影響を受ける関数の最適化をオフにします。

#pragma optimize(“”, off) 
// user’s function goes here. 
#pragma optimize(“”, on)

オプション 2: 変換に使われるソース変数を "揮発性" として宣言します。これによって、問題のある変換をコンパイラで回避できる場合があります。ただし、必ず回避できるとは限りません。

[2009 年 8 月] Unicode 書式設定関数および解析関数

問題: Windows 7 WDK には、Unicode バージョンの書式設定関数と解析関数に既知の問題があります。これらは、CRT のセキュリティ強化を構成する関数です。 Windows 7 用にビルドされたコードが Windows Vista または Windows Server 2008 で実行された場合、これらのセキュリティ強化により、間違った結果または AV となります。たとえば、Windows 7 のプリンタードライバーでポイントアンドプリントを使うと、ドライバーが、Windows Vista または Windows Server 2008 で正しく動作しなくなります。

回避策: この AV を回避するには、Unicode 関数が使われ、対象オペレーティングシステムが Windows 7 より前のバージョンである場合は必ず、このバージョン WDK で "_S なしのバージョン" (たとえば、swscanf_s ではなく、swscanf) を使います。

[2009 年 8 月] WttLogCm.dll が WDTF の WDK インストールに含まれていない

問題: WDK を使って WDTF をインストールすると、WttLogCm.dll のプラットフォーム固有のバージョンが含まれません。この .dll は、Common_Scenario_Stress_With_IO.wsf などの WDTF スクリプトの実行時に必要です。これらのスクリプトは、Cscript.exe を使って実行すると失敗し、次のエラーメッセージが表示されます。 [WTT ロガーが存在しません。WDTF を再インストールしてください。]

回避策: この問題を回避するには、次の手順を実行します。

Windows Server 2008 用 WDK をインストールしていない場合は、この WDK のコピーを入手し、ローカルコンピューターにインストールします。このバージョンの WDK は、WDK Connect Web サイトからダウンロードできます。
1. WDK Connect Web サイトにサインインします。
2. [My Connect Dashboard] (接続ダッシュボード) で [Windows Driver Kit] をクリックします。
3. Windows Driver Kit (WDK) のサイトで、左にある [ダウンロード] をクリックします。
4. [ダウンロード] で、[WDK と DDK のアーカイブ] をクリックします。
5. Windows Server 2008 (6.1..6001.18002) iso イメージを選び、[ダウンロード] をクリックします。
6. WDK iso イメージを DVD に書き込みます。
7. WDK をインストールします。
Windows Server 2008 WDK から、インストールした WDTF の SampleScripts ディレクトリに、WttLogCm.dll のプラットフォーム固有のバージョンをコピーします。WttLogCm.dll のプラットフォーム固有のバージョンは、Server2008WDKPath\tools\WDTF\%PROCESSOR_ARCHITECTURE%fre\redist\Extras ディレクトリにあります。ここで、Server2008WDKPath は Windows Server 2008 WDK をインストールしたディレクトリのパス (C:\WINDDK\6601.18002 など) を表します。
管理者特権のコマンドプロンプトを開き、インストールした WDTF の SampleScripts ディレクトリに移動します。その後、コマンドプロンプトで次のように入力し、Enter キーを押します。 Regsvr32 WttLogCM.dll

次の方法で共有

Windows Driver Kit (WDK) Version 7.1.0 リリースノート

WDK Version 7.1.0 の変更点と問題

RTM のリリースノート

[RTM Version 7.0.0] ライセンス情報

[RTM Version 7.0.0] インストール情報

[RTM Version 7.0.0] WDK ビルド環境の変更点と問題

[RTM Version 7.0.0] 再頒布可能な変更点と問題

[RTM Version 7.0.0] サンプルの変更点と問題

[RTM Version 7.0.0] ポータブルデバイス (WPD) ドライバーサンプルのメモリリーク

[RTM Version 7.0.0] ツールの変更点と問題

2009 年 8 月リリースノート

[2009 年 8 月] 間違ったデバイス ID が WPDMultiTransportDriver のインストール手順で指定される

[2009 年 8 月] 64 ビットでの、整数から浮動小数点数への変換により、コンパイラに問題が発生する可能性がある

[2009 年 8 月] Unicode 書式設定関数および解析関数

[2009 年 8 月] WttLogCm.dll が WDTF の WDK インストールに含まれていない

関連トピック

その他のリソース

次の方法で共有

Windows Driver Kit (WDK) Version 7.1.0 リリース ノート

WDK Version 7.1.0 の変更点と問題

RTM のリリース ノート

[RTM Version 7.0.0] ライセンス情報

[RTM Version 7.0.0] インストール情報

[RTM Version 7.0.0] WDK ビルド環境の変更点と問題

[RTM Version 7.0.0] 再頒布可能な変更点と問題

[RTM Version 7.0.0] サンプルの変更点と問題

[RTM Version 7.0.0] ポータブル デバイス (WPD) ドライバー サンプルのメモリ リーク

[RTM Version 7.0.0] ツールの変更点と問題

2009 年 8 月リリース ノート

[2009 年 8 月] 間違ったデバイス ID が WPDMultiTransportDriver のインストール手順で指定される

[2009 年 8 月] 64 ビットでの、整数から浮動小数点数への変換により、コンパイラに問題が発生する可能性がある

[2009 年 8 月] Unicode 書式設定関数および解析関数

[2009 年 8 月] WttLogCm.dll が WDTF の WDK インストールに含まれていない

関連トピック

その他のリソース

Windows Driver Kit (WDK) Version 7.1.0 リリースノート

RTM のリリースノート

[RTM Version 7.0.0] ポータブルデバイス (WPD) ドライバーサンプルのメモリリーク

2009 年 8 月リリースノート