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 で定義されているエラー コードのいずれかを返します。
注釈
ドライバーは I/O 要求を所有している必要があり、その I/O キューのいずれかから要求を取得している必要があります。
ソース キューと宛先キューを同じにすることはできません。 言い換えると、ドライバーは ForwardToIoQueue を呼び出して、着信元のキューに要求を返すことはできません。 元の I/O キューに I/O 要求を返すには、ドライバーは IWDFIoRequest2::Requeue を呼び出すことができます。
ソース キューと宛先キューの両方が同じデバイスに属している必要があります。
また、 ForwardToIoQueue メソッドは、 IWDFIoQueue::RetrieveNextRequest メソッドを呼び出してドライバーが取得した要求を再キューに入れることはできません。
要求を取り消すことはできません。 ドライバーが以前に IWDFIoRequest::MarkCancelable メソッドを呼び出して要求を取り消し可能にした場合、ドライバーは ForwardToIoQueue を呼び出す前に IWDFIoRequest::UnmarkCancelable メソッドを呼び出す必要があります。
例
次のコード例は、要求のバッファーが必要な情報を保持するのに不十分な場合に、要求を別のキューに転送する方法を示しています。
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 |
| Header | wudfddi.h (Wudfddi.h を含む) |
| [DLL] | WUDFx.dll |