PCAM_ALLOCATE_BW_ROUTINE Rückruffunktion (usbcamdi.h)

Artikel
02/26/2024

[CamAllocateBandwidth wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen CamAllocateBandwidthEx. ]

Die Rückruffunktion CamAllocateBandwidth 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 PcamAllocateBwRoutine;

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

Parameter

BusDeviceObject

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

DeviceContext

Zeiger auf den Gerätekontext des Kamera-Minitreibers.

RawFrameLength

Gibt die Größe der Rohframedaten aus dem Paketdatenstrom in Bytes an.

Format

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

Rückgabewert

CamAllocateBandwidth gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Kamera-Minidriver, die Abwärtskompatibilität mit dem ursprünglichen USBCAMD aufrechterhalten müssen, müssen die USBCAMD_DEVICE_DATA-Struktur und die zugehörigen Rückruffunktionen (d. a. Rückruffunktionen, die nicht das Suffix "Ex" enthalten) verwenden.

USBCAMD ruft die CamAllocateBandwidth-Rückruffunktion des Kamera-Minitreibers auf, unmittelbar bevor der isochrone Videoaufnahmestream gestartet wird. Es wird in Verbindung mit einem Run-Befehl aufgerufen.

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

Diese Funktion ist erforderlich.