Método IWDFIoRequest2::RetrieveOutputMemory (wudfddi.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método RetrieveOutputMemory recupera a interface IWDFMemory de um objeto de memória de estrutura que representa o buffer de saída de uma solicitação de E/S.

Sintaxe

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

Parâmetros

[out] Memory

O endereço de um local que recebe um ponteiro para a interface IWDFMemory de um objeto de memória UMDF.

Retornar valor

RetrieveOutputMemory retornará S_OK se a operação for bem-sucedida. Caso contrário, esse método pode retornar o seguinte valor:

Esse método pode retornar um dos outros valores que Winerror.h contém.

Comentários

O buffer de saída de uma solicitação recebe informações, como dados de um disco, que o driver fornece ao originador da solicitação. Seu driver pode chamar RetrieveOutputMemory para obter o buffer de saída para uma solicitação de leitura ou uma solicitação de controle de E/S do dispositivo, mas não para uma solicitação de gravação (porque as solicitações de gravação não fornecem dados de saída).

O método RetrieveOutputMemory recupera o buffer de saída para solicitações de E/S que usam o método de E/S em buffer ou E /S direto para acessar buffers de dados.

Se RetrieveOutputMemory retornar S_OK, o driver receberá um ponteiro para a interface IWDFMemory de um objeto de memória UMDF que representa o buffer de saída. Para acessar o buffer, o driver deve chamar IWDFMemory::GetDataBuffer.

O driver pode acessar o objeto de memória da estrutura recuperada até concluir a solicitação de E/S. Antes que o driver conclua a solicitação de E/S, ele deve chamar IWDFMemory::Release.

Em vez de chamar RetrieveOutputMemory, o driver pode chamar IWDFIoRequest2::RetrieveOutputBuffer, que recupera o endereço e o comprimento do buffer.

Para obter mais informações sobre como acessar os buffers de dados de uma solicitação de E/S, consulte Acessando buffers de dados em drivers de UMDF-Based.

Exemplos

O exemplo de código a seguir mostra como uma função de retorno de chamada IQueueCallbackRead::OnRead pode obter a interface IWDFMemory do objeto de memória da estrutura que representa o buffer de saída de uma solicitação de leitura. Em seguida, o exemplo formata e envia a solicitação de leitura para um destino de E/S USB.

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;
}

Requisitos

Confira também

IWDFIoRequest2

IWDFIoRequest2::RetrieveInputBuffer

IWDFIoRequest2::RetrieveInputMemory

IWDFIoRequest2::RetrieveOutputBuffer

IWDFIoRequest::GetInputMemory

IWDFIoRequest::GetOutputMemory