Compartilhar via


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)

Consulte também

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice

WDF_POWER_DEVICE_STATE