Método IPnpCallback::OnD0Entry (wudfddi.h)

Artigo
02/27/2024

[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.