次の方法で共有

IWDTFPNPActions2::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 コントローラーでこのメソッドを実行できます。

要件

要件 値
対象プラットフォーム デスクトップ
Header wdtfpnpaction.h