funzione WinUsb_GetPowerPolicy (winusb.h)

Articolo
03/04/2024

La funzione WinUsb_GetPowerPolicy recupera i criteri di alimentazione per un dispositivo. Si tratta di un'operazione sincrona.

Sintassi

BOOL WinUsb_GetPowerPolicy(
  [in]      WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in]      ULONG                   PolicyType,
  [in, out] PULONG                  ValueLength,
  [out]     PVOID                   Value
);

Parametri

[in] InterfaceHandle

Handle opaco per la prima interfaccia nel dispositivo, restituito da WinUsb_Initialize.

[in] PolicyType

Valore che specifica il parametro di power policy da recuperare in Valore. La tabella seguente descrive le costanti simboliche definite in Winusbio.h.

Tipo di criteri	Descrizione
AUTO_SUSPEND (0x81)	Se il chiamante specifica un criterio di alimentazione di AUTO_SUSPEND, WinUsb_GetPowerPolicy restituisce il valore del parametro criterio di sospensione automatica nel parametro Value . Se Value è TRUE (ovvero, non zero), lo stack USB sospende il dispositivo quando non vengono trasferiti in sospeso o gli unici trasferimenti in sospeso sono trasferimenti IN su un endpoint di interruzione o bulk. Il valore del valore del Registro di sistema DefaultIdleState determina il valore predefinito del parametro dei criteri di sospensione automatica. Il parametro Value deve puntare a una variabile UCHAR.
SUSPEND_DELAY (0x83)	Se il chiamante specifica un criterio di alimentazione di SUSPEND_DELAY, WinUsb_GetPowerPolicy restituisce il valore del parametro criterio di ritardo di sospensione in Valore. Il parametro dei criteri di ritardo di sospensione specifica la quantità minima di tempo, in millisecondi, che il driver WinUSB deve attendere dopo qualsiasi trasferimento prima di poter sospendere il dispositivo. Il valore deve puntare a una variabile ULONG.

Tipo di criteri

Descrizione

AUTO_SUSPEND

(0x81)

Se il chiamante specifica un criterio di alimentazione di AUTO_SUSPEND, WinUsb_GetPowerPolicy restituisce il valore del parametro criterio di sospensione automatica nel parametro Value .

Se Value è TRUE (ovvero, non zero), lo stack USB sospende il dispositivo quando non vengono trasferiti in sospeso o gli unici trasferimenti in sospeso sono trasferimenti IN su un endpoint di interruzione o bulk.

Il valore del valore del Registro di sistema DefaultIdleState determina il valore predefinito del parametro dei criteri di sospensione automatica.

Il parametro Value deve puntare a una variabile UCHAR.

SUSPEND_DELAY

(0x83)

Se il chiamante specifica un criterio di alimentazione di SUSPEND_DELAY, WinUsb_GetPowerPolicy restituisce il valore del parametro criterio di ritardo di sospensione in Valore.

Il parametro dei criteri di ritardo di sospensione specifica la quantità minima di tempo, in millisecondi, che il driver WinUSB deve attendere dopo qualsiasi trasferimento prima di poter sospendere il dispositivo.

Il valore deve puntare a una variabile ULONG.

[in, out] ValueLength

Puntatore alle dimensioni del buffer che Valore. Nell'output , ValueLength riceve le dimensioni dei dati copiati nel buffer Valore .

[out] Value

Buffer che riceve il parametro di power policy specificato. Per altre informazioni, vedere PolicyType.

Valore restituito

WinUsb_GetPowerPolicy restituisce TRUE se l'operazione ha esito positivo. In caso contrario, questa routine restituisce FALSE e il chiamante può recuperare l'errore registrato chiamando GetLastError.

GetLastError può restituire il codice di errore seguente.