EVT_WDF_IO_TARGET_QUERY_REMOVE função de retorno de chamada (wdfiotarget.h)
[Aplica-se a KMDF e UMDF]
A função de retorno de chamada de evento EvtIoTargetQueryRemove de um driver indica se a estrutura pode remover com segurança um dispositivo de destino de E/S remoto especificado.
Sintaxe
EVT_WDF_IO_TARGET_QUERY_REMOVE EvtWdfIoTargetQueryRemove;
NTSTATUS EvtWdfIoTargetQueryRemove(
[in] WDFIOTARGET IoTarget
)
{...}
Parâmetros
[in] IoTarget
Um identificador para um objeto de destino de E/S.
Retornar valor
A função de retorno de chamadaEvtIoTargetQueryRemove deve retornar STATUS_SUCCESS se o driver determinar que a estrutura pode remover com segurança o dispositivo do destino de E/S especificado. Caso contrário, essa função de retorno de chamada deverá retornar STATUS_UNSUCCESSFUL.
Comentários
Se a função de retorno de chamada EvtIoTargetQueryRemove de um driver retornar STATUS_SUCCESS, o sistema permitirá que o dispositivo do destino de E/S seja removido, a menos que outro driver retorne STATUS_UNSUCCESSFUL.
Para registrar uma função de retorno de chamada EvtIoTargetQueryRemove , coloque o endereço da função de retorno de chamada na estrutura WDF_IO_TARGET_OPEN_PARAMS do destino de E/S. A função de retorno de chamada EvtIoTargetQueryRemove é opcional. Não fornecer essa função de retorno de chamada é equivalente ao retorno de STATUS_SUCCESS.
A função de retorno de chamada EvtIoTargetQueryRemove deve chamar WdfIoTargetCloseForQueryRemove, se o driver determinar que o gerenciador PnP pode remover com segurança o dispositivo de destino.
A função de retorno de chamada deve desabilitar a capacidade do driver de enviar solicitações de E/S adicionais para o destino de E/S.
Para obter mais informações sobre a função de retorno de chamada EvtIoTargetQueryRemove , consulte Controlando o estado de um destino de E/S geral.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Versão mínima do UMDF | 2,0 |
| Cabeçalho | wdfiotarget.h (inclua Wdf.h) |
| IRQL | PASSIVE_LEVEL |