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

ターゲット デバイスにIRP_MN_STOP_DEVICE イベントの送信を試みます。

構文

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

パラメーター

[out, retval] pbSuccess

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

戻り値

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

備考

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

 

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

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

必要条件

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

関連項目

IWDTFPNPAction2