PCAM_ALLOCATE_BW_ROUTINE_EX Rückruffunktion (usbcamdi.h)

Die CamAllocateBandwidthEx-Rückruffunktion eines Kamera-Minidrivers wählt die entsprechende alternative Einstellung innerhalb der USB-Videostreamingschnittstelle aus und bereitet das Gerät auf das Streamen vor.

Syntax

PCAM_ALLOCATE_BW_ROUTINE_EX PcamAllocateBwRoutineEx;

NTSTATUS PcamAllocateBwRoutineEx(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PULONG RawFrameLength,
  PVOID Format,
  ULONG StreamNumber
)
{...}

Parameter

BusDeviceObject

Zeiger auf das Geräteobjekt des Kameraminidrivers, das vom USB-Hub erstellt wurde.

DeviceContext

Zeiger auf den Gerätekontext des Kameraminidrivers.

RawFrameLength

Gibt die Größe der rohen Framedaten aus dem Paketstream in Bytes an.

Format

Zeiger auf eine KS_DATAFORMAT_VIDEOINFOHEADER Struktur, die diesem Stream zugeordnet ist.

StreamNumber

Gibt die Streamnummer an.

Rückgabewert

CamAllocateBandwidthEx gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

USBCAMD ruft die CamAllocateBandwidthEx-Rückruffunktion des Kameraminidrivers auf, unmittelbar bevor der isochrone Videoaufnahmestream gestartet wird. Sie wird in Verbindung mit einem Befehl Ausführen aufgerufen.

In der Regel ruft diese Funktion den USBCAMD_SelectAlternateInterface-Dienst auf, um die richtige alternative Schnittstelle auszuwählen und das Streaming von Videos vorzubereiten.

Die ursprüngliche USBCAMD ruft CamAllocateBandwidthEx nicht auf.

Diese Funktion ist erforderlich.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	usbcamdi.h (einschließlich Usbcamdi.h)

Weitere Informationen

KS_DATAFORMAT_VIDEOINFOHEADER

USBCAMD_DEVICE_DATA2

USBCAMD_SelectAlternateInterface