Método IWDFRemoteTarget::Reopen (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]
El método Volver a abrir vuelve a abrir un de destino de E/S remoto después de que se haya cerrado temporalmente.
Sintaxis
HRESULT Reopen();
Valor devuelto
volver a abrir devuelve S_OK si la operación se realiza correctamente. De lo contrario, el método podría devolver el siguiente valor:
| Código devuelto | Descripción |
|---|---|
|
Error en el intento del marco de trabajo de asignar memoria. |
Este método podría devolver uno de los otros valores que contiene Winerror.h.
El comprobador del marco notifica un error si el marco no puede abrir el archivo.
Observaciones
Normalmente, un controlador llama a volver a abrir desde dentro de la IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled función de devolución de llamada, pero volver a abrir en su lugar se puede llamar después de OnRemoteTargetRemoveCanceled devuelve.
Volver a abrir usa el nombre de archivo o interfaz especificado anteriormente para IWDFRemoteTarget::OpenFileByName o IWDFRemoteTarget::OpenRemoteInterface. Si desea cambiar el archivo o la interfaz que usa el controlador, el controlador puede llamar a IWDFRemoteTarget::Closey, a continuación, puede llamar a OpenFileByName o OpenRemoteInterface en lugar de Volver a abrir.
Para obtener más información sobre volver a abrir y cómo usar destinos de E/S remotos en controladores basados en UMDF, consulte Controlar el estado de un destino de E/S general en UMDF.
Ejemplos
En el ejemplo de código siguiente se muestra un función de devolución de llamada IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled que llama a Volver a abrir.
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 |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.9 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |