次の方法で共有


IWDFIoTargetStateManagement::Stop メソッド (wudfddi.h)

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。

Stop メソッドは、キューに登録された要求の ローカル I/O ターゲットへの送信を停止します。

構文

HRESULT Stop(
  [in] WDF_IO_TARGET_SENT_IO_ACTION Action
);

パラメーター

[in] Action

I/O ターゲット オブジェクトが停止したときに送信された I/O を処理する方法を識別する WDF_IO_TARGET_SENT_IO_ACTION型指定された値。

戻り値

Stop は常にS_OKを返します。

備考

ドライバーが回復可能なデバイス エラーを検出できる場合は、ドライバーが Stop を呼び出してローカル I/O ターゲットへの要求の送信を一時的に停止し、後で IWDFIoTargetStateManagement::Start 呼び出して要求の送信を再開することができます。

さらに、ドライバーが IWDFUsbTargetPipe2::ConfigureContinuousReader を呼び出して USB パイプの連続リーダーを構成する場合、ドライバーの IPnpCallback::OnD0Exit コールバック関数は、リーダーを停止するために Stop を呼び出す必要があります。

ドライバーが Stopを呼び出した場合でも、IWDFIoRequest::Send を呼び出すときに WDF_REQUEST_OPTION_IGNORE_TARGET_STATE フラグ設定することで、ターゲットに要求を送信できます。 ドライバーがこのフラグを設定した場合、ドライバーは、USB パイプをリセットする要求などの要求を送信できます (IWDFUsbTargetPipe::Resetを参照)、ドライバーが Stopを呼び出した後、デバイスに。

ドライバー IWDFIoTargetStateManagement::Start を呼び出し、を同期的に停止 必要があります。 ドライバーは、これらの関数のいずれかを呼び出した後、最初の呼び出しが返される前に、どちらの関数も呼び出してはなりません。

ドライバーは、IWDFIoTargetStateManagement::Start 呼び出さずに、Stop を複数回呼び出すことができます。 たとえば、ドライバーによって次の操作が行われる場合があります。

  1. Stop を呼び出し、WdfIoTargetLeaveSentIoPending Action指定します。
  2. ターゲットが I/O 要求の処理を再開する必要があるかどうかを判断します。
  3. ターゲットが再開する必要がある場合は、IWDFIoTargetStateManagement::Startを呼び出します。 それ以外の場合は、ActionWdfIoTargetCancelSentIoを指定して、Stop を再度呼び出します。
停止の詳細については、「一般的な I/O ターゲットの状態の制御」を参照してください。

I/O ターゲットの詳細については、「I/O ターゲットの使用」を参照してください。

次のコード例は、ドライバーが USB パイプに連続リーダーを使用している場合に、IPnpCallback::OnD0Exit コールバック関数が Stopを呼び出す方法を示しています。 (IWDFIoTargetStateManagement インターフェイスを取得する方法については、IWDFIoTargetStateManagement::Startのコード例を参照してください)。

HRESULT
CMyDevice::OnD0Exit(
    __in IWDFDevice*  pWdfDevice,
    __in WDF_POWER_DEVICE_STATE  previousState
    )
{
    HRESULT hr;
    hr = m_pIoTargetInterruptPipeStateMgmt->Stop(WdfIoTargetCancelSentIo);
    return hr;
}

必要条件

要件 価値
サポート終了 UMDF 2.0 以降では使用できません。
ターゲット プラットフォーム デスクトップ
UMDF の最小バージョン する 1.5
ヘッダー wudfddi.h (Wudfddi.h を含む)
DLL WUDFx.dll

関連項目

IWDFIoTargetStateManagement

IWDFRemoteTarget::Stop