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_GetPowerPolicyValue 매개 변수에서 자동 일시 중단 정책 매개 변수의 값을 반환합니다. 값이 TRUE인 경우(즉, 0이 아닌 경우) USB 스택은 보류 중인 전송이 없거나 보류 중인 유일한 전송이 인터럽트 또는 대량 엔드포인트의 IN 전송일 때 디바이스를 일시 중단합니다. DefaultIdleState 레지스트리 값의 값은 자동 일시 중단 정책 매개 변수의 기본값을 결정합니다. Value 매개 변수는 UCHAR 변수를 가리킵니다.
SUSPEND_DELAY (0x83)	호출자가 SUSPEND_DELAY 전원 정책을 지정하는 경우 WinUsb_GetPowerPolicyValue에서 일시 중단 지연 정책 매개 변수의 값을 반환합니다. 일시 중단 지연 정책 매개 변수는 WinUSB 드라이버가 디바이스를 일시 중단하기 전에 전송 후 기다려야 하는 최소 시간(밀리초)을 지정합니다. 값은 ULONG 변수를 가리킵니다.

[in, out] ValueLength

값인 버퍼의 크기에 대한 포인터입니다. 출력 시 ValueLength 는 값 버퍼에 복사된 데이터의 크기를 받습니다.

[out] Value

지정된 전원 정책 매개 변수를 수신하는 버퍼입니다. 자세한 내용은 PolicyType을 참조하세요.

반환 값

WinUsb_GetPowerPolicy 작업이 성공하면 TRUE 를 반환합니다. 그렇지 않으면 이 루틴은 FALSE를 반환하고 호출자는 GetLastError를 호출하여 기록된 오류를 검색할 수 있습니다.

GetLastError 는 다음 오류 코드를 반환할 수 있습니다.

반환 코드	설명
ERROR_INVALID_HANDLE	호출자가 InterfaceHandle 매개 변수에서 NULL을 전달했습니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	winusb.h(Winusb.h 포함)
라이브러리	Winusb.lib
DLL	Winusb.dll

추가 정보

WinUSB

WinUSB 함수

WinUSB 전원 관리

WinUsb_Initialize