USBD_SelectInterfaceUrbAllocateAndBuild 함수(usbdlib.h)
USBD_SelectInterfaceUrbAllocateAndBuild 루틴은 요청이 인터페이스를 선택하거나 대체 설정을 변경하는 데 필요한 URB 구조를 할당하고 형식을 지정합니다.
구문
NTSTATUS USBD_SelectInterfaceUrbAllocateAndBuild(
[in] USBD_HANDLE USBDHandle,
[in] USBD_CONFIGURATION_HANDLE ConfigurationHandle,
PUSBD_INTERFACE_LIST_ENTRY InterfaceListEntry,
[out] PURB *Urb
);
매개 변수
[in] USBDHandle
USBD_CreateHandle 루틴에 대한 이전 호출에서 클라이언트 드라이버가 검색한 USBD 핸들입니다.
[in] ConfigurationHandle
드라이버 스택이 선택 구성 요청을 완료한 후 URB 구조의 UrbSelectConfiguration.ConfigurationHandle 멤버에서 USB 드라이버 스택에서 반환된 핸들입니다.
InterfaceListEntry
호출자가 할당한 USBD_INTERFACE_LIST_ENTRY 구조체에 대한 포인터입니다. 자세한 내용은 설명 부분을 참조하세요.
[out] Urb
USBD_SelectInterfaceUrbAllocateAndBuild 할당한 URB 를 수신하는 URB 구조체에 대한 포인터입니다. 클라이언트 드라이버는 드라이버가 USBD_UrbFree 호출하여 URB 사용을 마쳤을 때 URB를 해제해야 합니다.
반환 값
루틴은 NTSTATUS 코드를 반환합니다. 가능한 값은 다음 표에 나열된 상태 코드를 포함하지만 이에 국한되지 않습니다.
| 반환 코드 | 설명 |
|---|---|
|
루틴 호출이 성공했습니다. |
|
호출자가 매개 변수 중에서 NULL을 전달했습니다. |
|
호출을 완료하는 데 사용할 수 있는 메모리가 부족합니다. |
설명
클라이언트 드라이버는 디바이스에서 구성을 선택한 후 USBD_SelectInterfaceUrbAllocateAndBuild 루틴을 호출해야 합니다. 선택 구성 요청이 완료되면 클라이언트 드라이버는 URB의 UrbSelectConfiguration.ConfigurationHandle 멤버에서 구성 핸들을 받습니다. 해당 핸들은 USBD_SelectInterfaceUrbAllocateAndBuildConfigurationHandle 매개 변수에 지정해야 합니다.
클라이언트 드라이버는 USBD_SelectInterfaceUrbAllocateAndBuild 호출하여 선택한 구성에서 인터페이스의 대체 설정을 변경하는 선택 인터페이스 요청에 대한 URB를 할당하고 빌드합니다. USBD_SelectInterfaceUrbAllocateAndBuild 호출에서 클라이언트 드라이버는 USBD_INTERFACE_LIST_ENTRY 구조체에 대한 포인터를 할당하고 제공해야 합니다. 클라이언트 드라이버는 다음과 같이 구조체 멤버를 설정해야 합니다.
- InterfaceDescriptor 멤버는 선택할 대체 설정이 있는 인터페이스 설명자가 포함된 USB_INTERFACE_DESCRIPTOR 구조를 가리킵니다. 인터페이스 설명자는 구성 설명자와 연결된 인터페이스 및 엔드포인트 설명자를 가져오기 위한 이전 요청에서 가져옵니다.
- 인터페이스 멤버는 NULL이어야 합니다.
클라이언트 드라이버는 단일 선택 인터페이스 요청에서 여러 인터페이스의 대체 설정을 변경할 수 없습니다. 각 요청은 하나의 인터페이스만 대상으로 합니다.
선택 인터페이스 요청이 완료되면 USB 드라이버 스택은 선택한 대체 설정에 정의된 엔드포인트에 대해 열린 파이프에 대한 정보로 USBD_INTERFACE_INFORMATION 채웁니다. 클라이언트 드라이버는 USBD_INTERFACE_INFORMATION 파이프 멤버가 가리키는 배열을 검사하여 해당 파이프 핸들을 가져오고 향후 데이터 전송 요청에 대한 핸들을 저장할 수 있습니다.
클라이언트 드라이버는 동일한 대체 설정에 대한 다른 선택 인터페이스 요청에 대해서만USBD_SelectInterfaceUrbAllocateAndBuild 의해 할당된 URB를 다시 사용할 수 있습니다. 클라이언트 드라이버는 다른 유형의 요청이나 다른 대체 설정에 대한 다른 선택 인터페이스 요청에 URB를 다시 사용하면 안 됩니다 . 새 URB를 할당하는 대신 기존 URB를 다시 사용하는 것이 특정 시나리오에서 선호되는 방법입니다. 두 대역폭 요구 사항에 대해 정의된 두 가지 대체 설정이 있는 인터페이스가 있는 USB 오디오 디바이스를 고려합니다. 0 설정은 0 대역폭에 대해 정의됩니다. 설정 1은 특정 양의 대역폭을 사용하도록 정의됩니다. 클라이언트 드라이버는 디바이스가 사용 중인지 여부에 따라 두 설정 간에 자주 전환하려고 합니다. 이 시나리오를 구현하기 위해 클라이언트 드라이버는 설정당 하나씩 선택 인터페이스 요청에 대해 두 개의 URL을 할당할 수 있습니다. 클라이언트 드라이버는 디바이스로 보낼 소리가 있을 때 선택 인터페이스 요청에 URB를 사용하고 다시 사용하여 설정 1을 선택할 수 있습니다. 소리가 없을 때 대역폭을 절약하기 위해 클라이언트 드라이버는 다른 URB를 사용하여 설정 0으로 전환할 수 있습니다. 이 구현은 클라이언트 드라이버가 설정을 변경해야 할 때마다 각 선택 인터페이스 요청에 대해 URL을 할당하지 못하도록 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 WDK가 필요합니다. Windows Vista 이상 버전의 Windows 운영 체제를 대상으로 합니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | usbdlib.h |
| 라이브러리 | Usbdex.lib |
| IRQL | DISPATCH_LEVEL |