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

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

要件

要件
サポートされている最小のクライアント Windows XP Professional
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム デスクトップ
Header wdtfpnpaction.h

こちらもご覧ください

IWDTFPNPAction2