IWDTFPNPAction2::EDTTryStopDeviceFailRestart メソッド (wdtfpnpaction.h)

ターゲット デバイスにIRP_MN_STOP_DEVICE イベントを送信し、その後のデバイスの再起動に失敗します。

構文

HRESULT EDTTryStopDeviceFailRestart(
  [out, retval] VARIANT_BOOL *pbSuccess
);

パラメーター

[out, retval] pbSuccess

操作が成功した場合は True。それ以外の場合は false。

戻り値

このメソッドが成功した場合は、S_OKを返します。 それ以外の場合は、HRESULT エラー コードが返されます。

備考

注意IWDTFEnhancedDeviceTestSupportAction2::Enable メソッドは、このメソッドを呼び出す前に、ターゲット デバイスに対して呼び出す必要があります。

 

EDTTryStopDeviceFailRestart は、PnP リソースの再調整 (クエリの停止、停止、IRP の開始シーケンス) をトリガーしようとします。このシーケンスでは、正常なクエリの停止と停止の後に続くIRP_MN_START_DEVICE イベントが失敗します。 失敗したスタート IRP が原因で、システムがデバイスを突然削除します (IRP_MN_SURPRISE_REMOVAL)。

停止 IRP は保証されません。 スタック上の他のドライバーは、停止 IRP の前に (IRP_MN_CANCEL_STOP_DEVICEの結果) IRP_MN_QUERY_STOP_DEVICEイベントが失敗する可能性があります。 また、ターゲット デバイスがハードウェア リソース (USB マウスなど) を使用していないことを検出し、代わりに CancelStop IRP を送信すると、システムが最適化される場合があります。

デバイスがハードウェア リソースを消費しないが、ドライバーとアプリケーションが失敗した起動で PnP リソースの再調整をどのように処理するかをテストする場合は、代わりに、ハードウェア リソースを消費する親デバイス、祖父母などで EDTTryStopDeviceFailRestart メソッドを実行できます。 たとえば、デバイスが USB マウスの場合は、代わりに親 USB コントローラーでこのメソッドを実行できます。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP Professional
サポートされる最小サーバー	Windows Server 2008
ターゲット プラットフォーム の	デスクトップ
ヘッダー	wdtfpnpaction.h

関連項目

IWDTFPNPAction2