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 を複数回呼び出すことができます。 たとえば、ドライバーによって次の操作が行われる場合があります。
- Stop を呼び出し、WdfIoTargetLeaveSentIoPending の Action 値指定します。
- ターゲットが I/O 要求の処理を再開する必要があるかどうかを判断します。
- ターゲットが再開する必要がある場合は、IWDFIoTargetStateManagement::Startを呼び出します。 それ以外の場合は、Action 値 WdfIoTargetCancelSentIoを指定して、Stop を再度呼び出します。
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 の