WinUsb_GetPipePolicy 함수(winusb.h)

WinUsb_GetPipePolicy 함수는 디바이스의 엔드포인트와 연결된 특정 파이프에 대한 정책을 검색합니다. 동기 작업입니다.

구문

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

매개 변수

[in] InterfaceHandle

파이프가 연결된 엔드포인트를 포함하는 인터페이스에 대한 불투명 핸들입니다.

첫 번째 인터페이스에서 엔드포인트와 연결된 파이프를 쿼리하려면 WinUsb_Initialize 반환된 핸들을 사용합니다. 다른 모든 인터페이스의 경우 WinUsb_GetAssociatedInterface 검색된 대상 인터페이스에 대한 핸들을 사용합니다.

[in] PipeID

7비트 주소와 방향 비트로 구성된 8비트 값입니다. 이 매개 변수는 엔드포인트 설명자의 bEndpointAddress 필드에 해당합니다.

[in] PolicyType

검색할 정책 매개 변수를 지정하는 ULONG 변수입니다. 정책 매개 변수의 현재 값은 Value 매개 변수를 검색합니다. 파이프 정책의 동작에 대한 자세한 내용은 파이프 정책 수정을 위한 WinUSB 함수를 참조하세요.

[in, out] ValueLength

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

[out] Value

지정된 파이프 정책 값을 수신하는 버퍼에 대한 포인터입니다.

반환 값

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

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

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

요구 사항

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

추가 정보

WinUSB

WinUSB 함수

파이프 정책 수정을 위한 WinUSB 함수

WinUsb_Initialize

WinUsb_ReadPipe

WinUsb_WritePipe