次の方法で共有

IWDFIoRequest::ForwardToIoQueue メソッド (wudfddi.h)

  • [アーティクル]

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

ForwardToIoQueue メソッドは、呼び出し元のドライバーの I/O キューのいずれかに I/O 要求を転送 (つまり、再キュー) します。

構文

HRESULT ForwardToIoQueue(
  [in] IWDFIoQueue *pDestination
);

パラメーター

[in] pDestination

宛先キュー オブジェクトの IWDFIoQueue インターフェイスへのポインター。

戻り値

ForwardToIoQueue 、操作が成功した場合にS_OKを返します。 それ以外の場合、このメソッドは Winerror.h で定義されているエラー コードの 1 つを返します。

備考

ドライバーは I/O 要求を所有している必要があり、その I/O キューのいずれかから要求を取得している必要があります。

ソース キューと宛先キューを同じにすることはできません。 つまり、ドライバーは、ForwardToIoQueue を呼び出して、元のキューに要求を返すことはできません。 元の I/O キューに I/O 要求を返すには、ドライバーは IWDFIoRequest2::Requeue 呼び出すことができます。

ソース キューと宛先キューの両方が同じデバイスに属している必要があります。

また、ForwardToIoQueue メソッドは、IWDFIoQueue::RetrieveNextRequest メソッドを呼び出して取得したドライバーの要求を再キューすることはできません。

要求を取り消すことはできません。 ドライバーが以前に IWDFIoRequest::MarkCancelable メソッドを呼び出して要求を取り消し可能にした場合、ドライバーは IWDFIoRequest::UnmarkCancelable メソッドを呼び出してから ForwardToIoQueue 呼び出す必要があります。

例

次のコード例は、要求のバッファーが必要な情報を保持するのに不十分な場合に、要求を別のキューに転送する方法を示しています。

HRESULT hr;
 if (OutputBufferSizeInBytes < sizeof(SWITCH_STATE)) {
    hr = HRESULT_FROM_NT(ERROR_INSUFFICIENT_BUFFER);
 }
 else {
     hr = FxRequest->ForwardToIoQueue(
                          m_Device->GetSwitchChangeQueue()
                          );
     if (SUCCEEDED(hr)) {
         completeRequest = false;
     }
  }

必要条件

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

関連項目

IWDFIoQueue の

IWDFIoQueue::RetrieveNextRequest

IWDFIoRequest の

IWDFIoRequest::MarkCancelable

IWDFIoRequest::UnmarkCancelable