Método IPnpCallback::OnD0Entry (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. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com 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 do tipo WDF_POWER_DEVICE_STATE que identifica o estado de energia do dispositivo antes de entrar no estado de energia D0 .
Retornar valor
Se o retorno de chamada OnD0Entry não encontrar erros, ele deverá retornar S_OK ou outro código de status para o qual SUCCEEDED(status) é igual a TRUE.
Se ele retornar um código status para o qual SUCCEEDED(status) é igual a FALSE, a estrutura removerá o dispositivo. Se os drivers do dispositivo não forem compatíveis com outros dispositivos no sistema, o gerenciador de E/S descarregará os drivers. A estrutura notifica o gerenciador PnP, que tenta reiniciar o dispositivo solicitando que o motorista do barramento reenumere seus dispositivos. Se o driver tiver sido 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.
Comentários
Um driver registra a interface IPnpCallback quando chama o método IWDFDriver::CreateDevice para criar um objeto de dispositivo.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | wudfddi.h (include Wudfddi.h) |