Método IPnpCallback::OnD0Entry (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 .]
O método OnD0Entry notifica um driver quando um dispositivo entra no estado de energia D0 para que o driver possa executar as operações necessárias, como habilitar o dispositivo.
Sintaxe
HRESULT OnD0Entry(
[in] IWDFDevice *pWdfDevice,
[in] WDF_POWER_DEVICE_STATE previousState
);
Parâmetros
[in] pWdfDevice
Um ponteiro para a interface IWDFDevice para o objeto de dispositivo do dispositivo que entra no estado de energia D0.
[in] previousState
Um valor WDF_POWER_DEVICE_STATEdigitado que identifica o estado de energia do dispositivo antes de entrar no estado de energia D0.
Valor de retorno
Se o OnD0Entry retorno de chamada não encontrar erros, ele deverá retornar S_OK ou outro código de status para o qual SUCCEEDED(status) é igual a VERDADEIRO.
Se ele retornar um código de status para o qual SUCCEEDED(status) é igual a FALSE, a estrutura removerá o dispositivo. Se os drivers do dispositivo não estiverem suportando outros dispositivos no sistema, o gerente de E/S descarregará os drivers. A estrutura notifica o gerenciador PnP, que tenta reiniciar o dispositivo solicitando que o motorista do ônibus reenumere seus dispositivos. Se o seu motorista foi descarregado, ele será recarregado. Nesse caso, a estrutura não chamará a função de retorno de chamada IPnpCallback::OnD0Exit do driver.
Os códigos de erro HRESULT são definidos em Winerror.h.
Observações
Um driver registra a interface IPnpCallback quando chama o método IWDFDriver::CreateDevice para criar um objeto de dispositivo.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Windows |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |