IWDFIoRequest2::RetrieveOutputMemory メソッド (wudfddi.h)

[アーティクル]
02/07/2025

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

RetrieveOutputMemory メソッドは、I/O 要求の出力バッファーを表すフレームワークメモリオブジェクトの IWDFMemory インターフェイスを取得します。

構文

HRESULT RetrieveOutputMemory(
  [out] IWDFMemory **Memory
);

パラメーター

[out] Memory

UMDF メモリオブジェクトの IWDFMemory インターフェイスへのポインターを受け取る場所のアドレス。

戻り値

RetrieveOutputMemory は、操作が成功した場合にS_OKを返します。それ以外の場合、このメソッドは次の値を返すことができます。

リターンコード	形容
HRESULT_FROM_WIN32 (ERROR_INSUFFICIENT_BUFFER)	I/O 要求で入力バッファーが提供されませんでした。
E_OUTOFMEMORY	バッファーを取得するのに十分なメモリがありません。ドライバーは、エラー状態の値で要求を完了する必要があります。

このメソッドは、Winerror.h に含まれる他の値の 1 つを返す場合があります。

備考

要求の出力バッファーは、ドライバーが要求の発信元に提供するディスクからのデータなどの情報を受け取ります。ドライバーは、RetrieveOutputMemory を呼び出して、読み取り要求またはデバイス I/O 制御要求の出力バッファーを取得できますが、書き込み要求には呼び出しません (書き込み要求では出力データが提供されないため)。

RetrieveOutputMemory メソッドは、バッファー化された I/O を使用する I/O 要求またはデータバッファーにアクセスするための直接 I/O メソッド出力バッファーを取得します。

RetrieveOutputMemory がS_OKを返す場合、ドライバーは、出力バッファーを表す UMDF メモリオブジェクトの IWDFMemory インターフェイスへのポインターを受け取ります。バッファーにアクセスするには、ドライバーは IWDFMemory::GetDataBuffer 呼び出す必要があります。

ドライバーは、が I/O 要求完了するまで、取得したフレームワークメモリオブジェクトにアクセスできます。ドライバーが I/O 要求を完了する前に、IWDFMemory::Release 呼び出す必要があります。

ドライバーは、RetrieveOutputMemoryを呼び出す代わりに、バッファーのアドレスと長さを取得 IWDFIoRequest2::RetrieveOutputBufferを呼び出すことができます。

I/O 要求のデータバッファーへのアクセスの詳細については、「UMDF-Based ドライバーでのデータバッファーへのアクセス」を参照してください。

例

次のコード例は、IQueueCallbackRead::OnRead コールバック関数が、読み取り要求の出力バッファーを表すフレームワークメモリオブジェクトの IWDFMemory インターフェイスを取得する方法を示しています。次に、USB I/O ターゲットに読み取り要求を書式設定して送信します。

VOID
STDMETHODCALLTYPE
  CMyQueue::OnRead(
     __in IWDFIoQueue *pWdfQueue,
     __in IWDFIoRequest *pWdfRequest,
     __in SIZE_T BytesToRead
     )
{
    HRESULT hr = S_OK;
    IWDFMemory * pOutputMemory = NULL;

    //
    // Declare an IWDFIoRequest2 interface pointer and obtain the
    // IWDFIoRequest2 interface from the IWDFIoRequest interface.
    //
    CComQIPtr<IWDFIoRequest2> r2 = pWdfRequest;

    r2->RetrieveOutputMemory(&pOutputMemory);
    if (FAILED(hr)) goto Exit;

    hr = m_Device->GetInputPipe()->FormatRequestForRead(pWdfRequest,
                                                        NULL,
                                                        pOutputMemory,
                                                        NULL,
                                                        NULL);
Exit:
    if (FAILED(hr))
    {
        pWdfRequest->Complete(hr);
    }
    else
    {
        ForwardFormattedRequest(pWdfRequest, m_Device->GetInputPipe());
    }
    SAFE_RELEASE(pOutputMemory);
    return;
}

必要条件

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

次の方法で共有

IWDFIoRequest2::RetrieveOutputMemory メソッド (wudfddi.h)

構文

パラメーター

戻り値

備考

例

必要条件

関連項目

フィードバック

その他のリソース