USBCAMD_SelectAlternateInterface function (usbcamdi.h)
The USBCAMD_SelectAlternateInterface function selects an alternate setting within the USB video streaming interface.
Syntax
NTSTATUS USBCAMD_SelectAlternateInterface(
[in] PVOID DeviceContext,
[in, out] PUSBD_INTERFACE_INFORMATION RequestInterface
);
Parameters
[in] DeviceContext
Pointer to a device-specific context.
[in, out] RequestInterface
Pointer to a USBD_INTERFACE_INFORMATION structure initialized with the proper values for a SELECT_INTERFACE URB request. This interface structure corresponds to a single isochronous interface on the device.
Return value
USBCAMD_SelectAlternateInterface returns the status of the SELECT_INTERFACE USB bus driver request. Other possible error codes include:
| Return code | Description |
|---|---|
| STATUS_DEVICE_DATA_ERROR | USBCAMD failed to cancel outstanding bulk/interrupt IRPs. |
| STATUS_INSUFFICIENT_RESOURCES | There are insufficient resources to allocate the USB request block |
Remarks
On successful completion, the structure pointed to by the RequestInterface argument is filled in with the information from the SELECT_INTERFACE USB bus driver request.
This function is typically called by a camera minidriver in response to a request to allocate or free bandwidth. This function should not be called when any video streams in the minidriver are open and/or actively streaming data.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | usbcamdi.h (include Usbcamdi.h) |
| Library | Usbcamd2.lib |