Método IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove (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.]
A função de retorno de chamada de evento OnRemoteTargetQueryRemove de um driver baseado em UMDF determina se o dispositivo de um destino de E/S remoto pode ser interrompido e removido.
Sintaxe
BOOL OnRemoteTargetQueryRemove(
[in] IWDFRemoteTarget *pWdfRemoteTarget
);
Parâmetros
[in] pWdfRemoteTarget
Um ponteiro para a interface IWDFRemoteTarget de um objeto de destino remoto que representa um destino de E/S remoto. O driver obtém esse ponteiro quando chama IWDFDevice2::CreateRemoteTarget.
Retornar valor
Se o driver determinar que o dispositivo pode ser interrompido e removido, a função de retorno de chamada de evento OnRemoteTargetQueryRemove deverá retornar TRUE. Caso contrário, a função de retorno de chamada deverá retornar FALSE.
Comentários
Se o driver fornecer uma função de retorno de chamada de evento OnRemoteTargetQueryRemove , a função de retorno de chamada deverá determinar se o sistema operacional deve permitir a remoção do dispositivo. Se o driver determinar que o dispositivo pode ser removido, ele deverá fazer o seguinte:
- Execute todas as ações específicas do driver necessárias para interromper a E/S para o destino remoto.
- Chame IWDFRemoteTarget::CloseForQueryRemove.
- Retornar TRUE para indicar que a remoção pode ocorrer.
Se o driver não fornecer essa função de retorno de chamada, a estrutura chamará IWDFRemoteTarget::CloseForQueryRemove para o driver. Em outras palavras, a estrutura sempre permite que o dispositivo seja removido, a menos que o driver forneça uma função de retorno de chamada de evento OnRemoteTargetQueryRemove .
Para obter mais informações sobre a função de retorno de chamada de evento OnRemoteTargetQueryRemove , consulte Controlando o estado de um destino de E/S geral no UMDF.
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) |