Método IWDFRemoteTarget::Reopen (wudfddi.h)

Artigo
02/07/2025

[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 Reopen reabre um de destino de E/S remoto depois de ter sido temporariamente fechado.

Sintaxe

HRESULT Reopen();

Valor de retorno

Reabra retorna 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 de da estrutura relatará um erro se a estrutura não puder abrir o arquivo.

Observações

Normalmente, um driver chama Reabrir de dentro da função de retorno de chamada IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled função de retorno de chamada, mas Reabra pode ser chamado depois de OnRemoteTargetovRemeCanceled retorna.

O 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 poderá chamar IWDFRemoteTarget::Fechare, 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 noumDF.

Exemplos

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

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.
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

Consulte também

IWDFRemoteTarget

IWDFRemoteTarget::Close

Compartilhar via