Método IWDFRemoteTarget::Reopen (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 Reopen reabre um destino de E/S remoto depois de ter sido temporariamente fechado.

Sintaxe

HRESULT Reopen();

Retornar valor

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

Código de retorno	Descrição
E_OUTOFMEMORY	Falha na tentativa da estrutura de alocar memória.

 

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

O verificador da estrutura relatará um erro se a estrutura não puder abrir o arquivo.

Comentários

Normalmente, um driver chama Reopen de dentro da função de retorno de chamada IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled , mas Reopen pode ser chamado após o retorno de OnRemoteTargetRemoveCanceled .

Reopen usa o nome do arquivo ou da interface especificado anteriormente para IWDFRemoteTarget::OpenFileByName ou IWDFRemoteTarget::OpenRemoteInterface. Se você quiser alterar o arquivo ou a interface que o driver está usando, o driver pode chamar IWDFRemoteTarget::Close e, em seguida, pode chamar OpenFileByName ou OpenRemoteInterface em vez de Reabrir.

Para obter mais informações sobre Reabrir e como usar destinos de E/S remotos em drivers baseados em UMDF, consulte Controlando o estado de um destino de E/S geral no UMDF.

Exemplos

O exemplo de código a seguir mostra uma função de retorno de chamada IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled que chama Reopen.

VOID 
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetRemoveCanceled(
    __in IWDFRemoteTarget* FxTarget
    )
{
 if (S_OK == (FxTarget->Reopen()))
    {
    //
    // Resume sending I/O requests to the remote target.
    //
    ...
    }
 else
    {
       FxTarget->Close();
    }
}

Requisitos

Requisito	Valor
Fim do suporte	Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino	Área de Trabalho
Versão mínima do UMDF	1,9
Cabeçalho	wudfddi.h (inclua Wudfddi.h)
DLL	WUDFx.dll

Confira também

IWDFRemoteTarget

IWDFRemoteTarget::Close