次の方法で共有


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

ターゲット デバイスにIRP_MN_STOP_DEVICE イベントを送信し、ターゲット デバイスに新しいリソースを割り当てようとします。

構文

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

パラメーター

[out, retval] pbSuccess

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

戻り値

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

備考

注意IWDTFEnhancedDeviceTestSupportAction2::Enable メソッドは、このメソッドを呼び出す前に、ターゲット デバイスに対して呼び出す必要があります。
 
EDTtryStopDevice メソッドと同様に、EDTTryStopDeviceRequestNewResources は、ターゲット デバイス スタックで PnP リソースの再調整 (たとえば、IRP_MN_STOP_DEVICE) をトリガーしようとします。さらに、メソッドはデバイスを新しいハードウェア リソースセットに強制的に適用しようとします。

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

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

必要条件

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

関連項目

IWDTFPNPAction2