PCAM_ALLOCATE_BW_ROUTINE 콜백 함수(usbcamdi.h)

[CamAllocateBandwidth는 지원되지 않으며 나중에 변경되거나 사용할 수 없습니다. 대신 CamAllocateBandwidthEx를 사용합니다. ]

카메라 미니드라이버의 CamAllocateBandwidth 콜백 함수는 USB 비디오 스트리밍 인터페이스 내에서 적절한 대체 설정을 선택하고 디바이스가 스트리밍되도록 준비합니다.

구문

PCAM_ALLOCATE_BW_ROUTINE PcamAllocateBwRoutine;

NTSTATUS PcamAllocateBwRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PULONG RawFrameLength,
  PVOID Format
)
{...}

매개 변수

BusDeviceObject

USB 허브에서 만든 카메라 미니드라이버의 디바이스 개체에 대한 포인터입니다.

DeviceContext

카메라 미니 드라이버의 디바이스 컨텍스트에 대한 포인터입니다.

RawFrameLength

패킷 스트림의 원시 프레임 데이터의 크기를 바이트 단위로 지정합니다.

Format

이 스트림과 연결된 KS_DATAFORMAT_VIDEOINFOHEADER 구조체에 대한 포인터입니다.

반환 값

CamAllocateBandwidth 는 STATUS_SUCCESS 또는 적절한 오류 코드를 반환합니다.

설명

원래 USBCAMD와 이전 버전과의 호환성을 유지해야 하는 카메라 미니드라이버에서는 USBCAMD_DEVICE_DATA 구조와 관련 콜백 함수(즉, "Ex" 접미사가 포함되지 않은 콜백 함수)를 사용해야 합니다.

USBCAMD는 등시 비디오 캡처 스트림이 시작되기 직전에 카메라 미니드라이버의 CamAllocateBandwidth 콜백 함수를 호출합니다. 실행 명령과 관련하여 호출됩니다.

일반적으로 이 함수는 USBCAMD_SelectAlternateInterface 서비스를 호출하여 올바른 대체 인터페이스를 선택하고 스트리밍 비디오를 준비합니다.

이 함수는 필수입니다.

요구 사항

추가 정보

CamAllocateBandwidthEx

KS_DATAFORMAT_VIDEOINFOHEADER

USBCAMD_SelectAlternateInterface