次の方法で共有


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

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

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

構文

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

パラメーター

[out] Memory

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

戻り値

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

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

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

注釈

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

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

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

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

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

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

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

VOID
STDMETHODCALLTYPE
  CMyQueue::OnWrite(
    __in IWDFIoQueue *pWdfQueue,
    __in IWDFIoRequest *pWdfRequest,
    __in SIZE_T BytesToWrite
    )
{
    HRESULT hr = S_OK;
    IWDFMemory * pInputMemory = NULL;
    IWDFUsbTargetPipe * pOutputPipe = m_Device->GetOutputPipe();
    //
    // Declare an IWDFIoRequest2 interface pointer and obtain the
    // IWDFIoRequest2 interface from the IWDFIoRequest interface.
    //
    CComQIPtr<IWDFIoRequest2> r2 = pWdfRequest;

    hr = r2->RetrieveInputMemory(&pInputMemory);
    if (FAILED(hr)) goto Exit;

    hr = pOutputPipe->FormatRequestForWrite(
                                           pWdfRequest,
                                           NULL, //pFile
                                           pInputMemory,
                                           NULL, //Memory offset
                                           NULL  //DeviceOffset
                                           );
Exit:
    if (FAILED(hr))
    {
        pWdfRequest->Complete(hr);
    }
    else
    {
        ForwardFormattedRequest(pWdfRequest, pOutputPipe);
    }
    SAFE_RELEASE(pInputMemory);
 return;
}

要件

要件
サポート終了 UMDF 2.0 以降では使用できません。
対象プラットフォーム デスクトップ
最小 UMDF バージョン 1.9
Header wudfddi.h (Wudfddi.h を含む)
[DLL] WUDFx.dll

こちらもご覧ください

IWDFIoRequest2

IWDFIoRequest2::RetrieveInputBuffer

IWDFIoRequest2::RetrieveOutputBuffer

IWDFIoRequest2::RetrieveOutputMemory

IWDFIoRequest::GetInputMemory

IWDFIoRequest::GetOutputMemory