Método IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove (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 .]
Uma 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 de destino de E/S remoto. O driver obtém esse ponteiro quando chama IWDFDevice2::CreateRemoteTarget.
Valor de retorno
Se o driver determinar que o dispositivo pode ser interrompido e removido, a função de retorno de chamada de evento OnRemoteTargetQueryRemove deverá retornar verdadeiro. Caso contrário, a função de retorno de chamada deverá retornar FALSE.
Observações
Se o driver fornecer uma função de retorno de chamada 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.
- Chamar IWDFRemoteTarget::CloseForQueryRemove.
- Retorne 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 um OnRemoteTargetQueryRemove função de retorno de chamada de evento.
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 noUMDF.
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) |