Método IWDFIoRequest2::Reuse (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo 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 aoda UMDF .]
O método Reutilizar reinicializa um objeto de solicitação de estrutura para que ele possa ser reutilizado.
Sintaxe
void Reuse(
[in] HRESULT hrNewStatus
);
Parâmetros
[in] hrNewStatus
Um valor de status tipo HRESULT que a estrutura atribui à solicitação.
Valor de retorno
Nenhum
Observações
Se um driver baseado em estrutura chamar IWDFDevice::CreateRequest para criar objetos de solicitação, o driver poderá reutilizar esses objetos de solicitação. Os drivers também podem reutilizar objetos de solicitação que recebem da estrutura em suas filas de E/S.
Um driver pode reutilizar um objeto de solicitação após a conclusão da solicitação original. Depois que um driver tiver chamado Reutilizar, o conteúdo da solicitação deverá ser reinicializado.
Se você quiser que a solicitação reutilizado tenha uma função de retorno de chamada IRequestCallbackRequestCompletion::OnCompletion, o driver deverá chamar IWDFIoRequest::SetCompletionCallback depois de chamar Reutilizar.
Para obter mais informações sobre Reutilizar, consulte Reutilizando objetos de solicitação da estrutura.
Exemplos
O exemplo de código a seguir mostra como uma função de retorno de chamada IRequestCallbackRequestCompletion::OnCompletion pode obter a interface de IWDFIoRequest2 e chamar Reutilizar.
void
STDMETHODCALLTYPE
CMyRemoteDevice::OnCompletion(
__in IWDFIoRequest* FxRequest,
__in IWDFIoTarget* FxTarget,
__in IWDFRequestCompletionParams* Params,
__in void* Context
)
{
...
CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
fxRequest2->Reuse(S_OK);
...
}
Requisitos
| Requisito | Valor |
|---|---|
| fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.9 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| de DLL | WUDFx.dll |