PCAM_CONFIGURE_ROUTINE 콜백 함수(usbcamdi.h)

아티클
03/01/2024

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

카메라 미니드라이버의 CamConfigure 콜백 함수는 등시 스트리밍 인터페이스를 구성합니다.

구문

PCAM_CONFIGURE_ROUTINE PcamConfigureRoutine;

NTSTATUS PcamConfigureRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PUSBD_INTERFACE_INFORMATION Interface,
  PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  PLONG DataPipeIndex,
  PLONG SyncPipeIndex
)
{...}

매개 변수

BusDeviceObject

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

DeviceContext

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

Interface

SELECT_INTERFACE URB 요청에 대한 적절한 값으로 초기화된 USBD_INTERFACE_INFORMATION 구조체에 대한 포인터입니다. 이 인터페이스 구조는 디바이스의 단일 등시 인터페이스에 해당합니다.

ConfigurationDescriptor

이 디바이스의 초기화된 USB_CONFIGURATION_DESCRIPTOR 대한 포인터입니다.

DataPipeIndex

데이터 파이프의 인덱스 를 나타내는 값에 대한 포인터입니다. 카메라 미니드라이버가 반환하기 전에 이 값을 입력해야 합니다.

SyncPipeIndex

필요한 경우 동기화 파이프의 인덱스 를 나타내는 값에 대한 포인터입니다. 카메라 미니드라이버가 반환하기 전에 이 값을 입력해야 합니다.

반환 값

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

설명

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

USBCAMD는 카메라 미니드라이버의 CamConfigure 콜백 함수를 호출하여 등시 스트리밍 인터페이스를 구성합니다. 이 함수가 반환된 후 USBCAMD는 유휴 상태에 사용할 USB 비디오 스트리밍 인터페이스 내의 인터페이스 및 대체 설정에 대해 알림을 받을 수 있습니다.

이 함수는 필수입니다.