DF - PNP 停止 (再調整) デバイス テスト (開発および統合)

  • [アーティクル]

このテストは、再調整手順を開始し、その結果としてデバイス ドライバーに対する IRP_MN_QUERY_STOP_DEVICE PnP IRP が実行されます。

スタック内のいずれかのドライバーでこの IRP が失敗した場合、再調整手順は破棄されます。 Vista では、Windows の再調整がサポートされています。 非リーフ デバイス ノードで再調整が開始された場合、そのデバイス ノードをルートとして持つデバイス ツリーに存在するデバイス スタックもすべて再調整されます。 また、いずれかの子デバイス スタックがクエリの停止に失敗した場合は、再調整プロシージャ全体が破棄されます。 そのため、ドライバーは、正規の理由なしにクエリの停止に失敗しないようにする必要があります"。 このエラーが発生した場合、PnP マネージャーは、クエリの停止が送信されたすべてのデバイス スタックに停止のキャンセル (IRP_MN_CANCEL_STOP) を送信します。

関係するすべてのデバイス スタックがクエリの停止に合格した場合、テストは再調整を続行し、IRP_MN_QUERY_RESOURCE_REQUIREMENTS と IRP_MN_FILTER_RESOURCE_REQUIREMENTS IRPS を送信して、デバイスのリソース要件を見つけます。

この後、ターゲット デバイスがリソースを使用するかどうかに応じて、次の 2 つの異なるパスが可能になります：

  • デバイスがリソースを消費しない場合、PnP マネージャー自体は、最適化としてキャンセル停止 (IRP_MN_CANCEL_STOP_DEVICE) を送信します。

    デバイスが実際にリソースを消費する場合、再調整手順は、IRP_MN_STOP_DEVICE と IRP_MN_START_DEVICE IRPs で完了します。

このテストでは、デバイスのリソースは変わりません。

  • テスト バイナリ: Devfund_PnPDTest.dll
  • テスト メソッド: PNPTryStopAndRestartDevice

拡張デバイス テスト (EDT) のサポートを無効にするテストでは、DQ パラメーターを使用して指定されたデバイスの上位フィルターとしてのテスト フィルター ドライバー (msdmfilt.sys) がアンインストールされます。 このテスト フィルターは、このテスト カテゴリで実行中のテストの一部としてインストールされます

  • テスト バイナリ: Devfund_PnPDTest.dll
  • テスト メソッド: DisableEnhancedDeviceTestingSupport

テストの詳細

   
仕様
  • Device.DevFund.Reliability.Discretional
プラットフォーム
  • Windows 10、クライアント エディション (x86)
  • Windows 10、クライアント エディション (x64)
  • Windows Server 2016 (x64)
  • Windows 10、クライアント エディション (Arm64)
  • Windows 10、モバイル エディション (Arm)
  • Windows 10、モバイル エディション (Arm64)
サポートされているリリース
  • Windows 10
  • Windows 10 バージョン 1511
  • Windows 10 Version 1607
  • Windows 10 Version 1703
  • Windows 10 バージョン 1709
  • Windows 10 バージョン 1803
  • Windows 10 Version 1809
  • Windows 10 バージョン 1903
  • Windows 10 への次の更新プログラム
予想される実行時間 (分) 3
カテゴリ シナリオ
タイムアウト (分) 45
再起動が必要です false
特別な構成が必要です true
Type automatic

 

その他のドキュメント

この機能領域のテストには、前提条件、セットアップ、トラブルシューティング情報など、次のトピックに記載されている追加のドキュメントが含まれている場合があります。

テストの実行

テストを実行する前に、「Device.Fundamentals の信頼性テストの前提条件」で説明されているテスト要件に従って、テストのセットアップを完了します。

トラブルシューティング

HLK テスト エラーの一般的なトラブルシューティングについては、「Windows HLK テストのエラーのトラブルシューティング」を参照してください。

HLK と WDK での Device Fundamentals テストに固有のトラブルシューティング情報は、Device.DevFund のその他のドキュメントを参照してください。

詳細

パラメーター

パラメーター名 パラメーターの説明
DQ ターゲット デバイスを識別するために使用される WDTF SDEL クエリ - https://go.microsoft.com/fwlink/?LinkId=232678
Wpa2PskAesSsid DUT またはその子デバイスの 1 つが WiFi アダプターの場合にのみ必要です。 WiFi アダプターのテストに使用できる WPA2 AES WiFi ネットワークの SSID を指定してください。 既定値は 'kitstestssid' です。
Wpa2PskPassword DUT またはその子デバイスの 1 つが WiFi アダプターの場合にのみ必要です。 Wpa2PskAesSsid パラメーターを使って指定された WPA2 AES WiFi ネットワークのパスワードを指定してください。 既定値は 'password' です。
WDTFREMOTESYSTEM DUT またはその子デバイスの 1 つが、IPv6 ゲートウェイ アドレスのないワイヤード (有線) NIC である場合にのみ必要です。 必要と判断された場合は、テスト NIC がネットワーク I/O をテストするために ping を実行できる IPv6 アドレスを指定してください。 例: fe80::78b6:810:9c12:46cd
DriverVerifierAdditionalDrivers ドライバーの検証ツールを有効にする必要がある追加のドライバー
DriverVerifierExcludedFlags テスト実行の際に手動で除外できるドライバー検証ツール フラグのプレースホルダー
MultiDeviceHardwareIdSdelQueryHardwareID マルチ デバイス SDEL
MultiDeviceInstanceIdSdelWDKDeviceID DUT のデバイス ID
DriverVerifierCustomizeConfiguration このテストでドライバーの検証の設定を自動的に更新することを指定します
TestCycles テストを実行するサイクル数。
DoSimpleIO True または False。 PNP 操作の実行の前後に、テスト デバイスで SimpleIO (見つかった場合) を実行します。
IOPeriod SimpleIO の分単位の実行時間 (見つかった場合)。
DoConcurrentIO True または False。 WDTF 同時 IO インターフェイスを使って、PNP 操作の実行中に対象のデバイス スタックに I/O 要求を送信します。