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

Artigo
03/01/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. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método OnD0Exit notifica um driver quando um dispositivo sai do estado de energia D0 para que o driver possa executar as operações necessárias, como desabilitar o dispositivo.

Sintaxe

HRESULT OnD0Exit(
  [in] IWDFDevice             *pWdfDevice,
  [in] WDF_POWER_DEVICE_STATE newState
);

Parâmetros

[in] pWdfDevice

Um ponteiro para a interface IWDFDevice para o objeto de dispositivo do dispositivo que sai do estado de energia D0.

[in] newState

Um valor de tipo WDF_POWER_DEVICE_STATE que identifica o novo estado de energia para o qual o dispositivo está definido depois que ele sai do estado de energia D0.

Retornar valor

Se o método de retorno de chamada OnD0Exit não encontrar erros, ele deverá retornar S_OK ou outro código status para o qual SUCCEEDED(status) é igual a TRUE. Caso contrário, ele deverá retornar um código status para o qual SUCCEEDED(status) é igual a FALSE. Os códigos de erro HRESULT são definidos em Winerror.h.