UsbBuildOpenStaticStreamsRequest 함수(usbdlib.h)

  • 아티클

UsbBuildOpenStaticStreamsRequest 인라인 함수는 오픈 스트림 요청에 대한 URB 구조 형식을 지정합니다. 요청은 지정된 대량 엔드포인트와 연결된 스트림을 엽니다.

구문

void UsbBuildOpenStaticStreamsRequest(
  [in, out] PURB                     Urb,
  [in]      USBD_PIPE_HANDLE         PipeHandle,
  [in]      USHORT                   NumberOfStreams,
  [in]      PUSBD_STREAM_INFORMATION StreamInfoArray
);

매개 변수

[in, out] Urb

오픈 스트림 요청(URB_FUNCTION_OPEN_STATIC_STREAMS)에 대한 형식을 지정할 URB 구조체에 대한 포인터입니다. 호출자는 이 URB에 대해 페이지가 없는 풀을 할당해야 합니다.

[in] PipeHandle

열 스트림이 포함된 엔드포인트와 연결된 파이프에 대한 불투명 핸들입니다.

클라이언트 드라이버는 이전의 select-configuration 요청(URB_FUNCTION_SELECT_CONFIGURATION) 또는 select-interface 요청(URB_FUNCTION_SELECT_INTERFACE)에서 PipeHandle 을 가져옵니다.

[in] NumberOfStreams

열 스트림 수입니다. NumberOfStreams 값은 Streams가 가리키는 배열의 요소 수를 나타냅니다. 이 값은 0보다 크고 호스트 컨트롤러 하드웨어에서 지원하는 최대 스트림 수보다 작거나 같아야 합니다. 지원되는 스트림의 최대 수를 얻으려면 USBD_QueryUsbCapability 호출합니다.

또한 개수 스트림은 USB 디바이스에서 지원하는 최대 스트림 수보다 작거나 같아야 합니다. 해당 번호를 얻으려면 엔드포인트 도우미 설명자를 검사합니다.

NumberOfStreams 값에서 호스트 컨트롤러와 USB 디바이스에서 지원하는 두 값 중 더 작은 값을 지정합니다.

[in] StreamInfoArray

호출자가 할당하고 초기화된 USBD_STREAM_INFORMATION 구조체 배열에 대한 포인터입니다. 배열의 길이는 열 스트림 수에 따라 달라지며 NumberOfStreams 값과 동일해야 합니다.

반환 값

없음

설명

오픈 스트림 요청에 필요한 URB 형식을 보여 주는 코드 예제는 USB 대량 엔드포인트에서 정적 스트림을 열고 닫는 방법을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 WDK가 필요합니다. Windows Vista 이상 버전의 Windows 운영 체제를 대상으로 합니다.
대상 플랫폼 데스크톱
머리글 usbdlib.h

추가 정보

USB 대량 엔드포인트에서 정적 스트림을 열고 닫는 방법

_URB_OPEN_STATIC_STREAMS