WinUsb_GetPowerPolicy函式 (winusb.h)
WinUsb_GetPowerPolicy函式會擷取裝置的電源原則。 這是同步作業。
語法
BOOL WinUsb_GetPowerPolicy(
[in] WINUSB_INTERFACE_HANDLE InterfaceHandle,
[in] ULONG PolicyType,
[in, out] PULONG ValueLength,
[out] PVOID Value
);
參數
[in] InterfaceHandle
裝置上第一個介面的不透明句柄，由 WinUsb_Initialize傳回。
[in] PolicyType
值，指定要在 Value 中擷取的電源原則參數。 下表描述 Winusbio.h 中定義的符號常數。
| 原則類型 | Description |
|---|---|
|
AUTO_SUSPEND (0x81) |
如果呼叫端指定AUTO_SUSPEND的電源原則， WinUsb_GetPowerPolicy 會傳回 Value 參數中自動暫停原則參數的值。
如果 Value 為 TRUE (也就是非零) ，則當沒有暫止傳輸或唯一擱置的傳輸是在中斷或大量端點上的 IN 傳輸時，USB 堆疊會暫停裝置。 DefaultIdleState 登錄值的值會決定自動暫停原則參數的預設值。 Value 參數必須指向UCHAR變數。 |
|
SUSPEND_DELAY (0x83) |
如果呼叫端指定SUSPEND_DELAY的電源原則， WinUsb_GetPowerPolicy 會傳回 Value 中暫停延遲原則參數的值。
暫止延遲原則參數會指定 WinUSB 驅動程式必須在任何傳輸之後等待的時間下限，才能暫停裝置。 值 必須指向ULONG變數。 |
[in, out] ValueLength
值之緩衝區大小的指標。 輸出時， ValueLength 會接收複製到 Value 緩衝區的數據大小。
[out] Value
接收指定電源原則參數的緩衝區。 如需詳細資訊，請參閱 PolicyType。
傳回值
如果 作業成功，WinUsb_GetPowerPolicy傳回 TRUE 。 否則，這個例程會傳回 FALSE，而呼叫端可以呼叫 GetLastError 來擷取記錄的錯誤。
GetLastError 可以傳回下列錯誤碼。
| 傳回碼 | Description |
|---|---|
|
呼叫端在 InterfaceHandle 參數中傳遞 NULL。 |
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | winusb.h (包含 Winusb.h) |
| 程式庫 | Winusb.lib |
| Dll | Winusb.dll |