Método IWDFUsbTargetDevice::SetPowerPolicy (wudfusb.h)

  • Artigo

[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 SetPowerPolicy define a política de energia do WinUsb.

Sintaxe

HRESULT SetPowerPolicy(
  [in] ULONG PolicyType,
  [in] ULONG ValueLength,
  [in] PVOID Value
);

Parâmetros

[in] PolicyType

O tipo de política de energia do WinUsb que o driver UMDF define.

[in] ValueLength

O tamanho, em bytes, do buffer que SetPowerPolicy fornece em Value.

[in] Value

Um ponteiro para o buffer que contém a política de energia do WinUsb.

Retornar valor

SetPowerPolicy retorna um dos seguintes valores:

Código de retorno Descrição
S_OK

SetPowerPolicy definiu com êxito a política de energia do WinUsb.
E_OUTOFMEMORY

SetPowerPolicy encontrou uma falha de alocação.
Um código de erro definido em Winerror.h
 Esse valor corresponde ao código de erro retornado pela API do WinUsb.

Comentários

A política de energia controla o gerenciamento de energia que o WinUsb para o dispositivo executa.

Para obter informações sobre tipos de política válidos e valores que um driver UMDF pode passar para os parâmetros PolicyType e Value , consulte a função WinUsb_SetPowerPolicy .

Para obter mais informações sobre o comportamento de energia do WinUSB, consulte Gerenciamento de Energia do WinUSB.

O método SetPowerPolicy gera uma solicitação UMDF e envia a solicitação de forma síncrona para o destino de E/S.

Requisitos

Requisito Valor
Fim do suporte Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino Área de Trabalho
Versão mínima do UMDF 1.5
Cabeçalho wudfusb.h (inclua Wudfusb.h)
DLL WUDFx.dll

Confira também

IWDFUsbTargetDevice

IWDFUsbTargetDevice::RetrievePowerPolicy

WinUsb_SetPowerPolicy