Freigeben über


PCAM_ALLOCATE_BW_ROUTINE Rückruffunktion (usbcamdi.h)

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

Die CamAllocateBandwidth Rückruffunktion eines Kamera-Minidrivers wählt die entsprechende alternative Einstellung in 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 Kameraminidrivers, das vom USB-Hub erstellt wurde.

DeviceContext

Zeigen Sie auf den Gerätekontext des Kamera-Minidrivers.

RawFrameLength

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

Format

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

Rückgabewert

CamAllocateBandwidth gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Bemerkungen

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

USBCAMD ruft die CamAllocateBandwidth Rückruffunktion des Kameraminidrivers unmittelbar vor dem Start des isochronen Videoaufnahmedatenstroms auf. 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 sich auf das Streaming von Video vorzubereiten.

Diese Funktion ist erforderlich.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- usbcamdi.h (include Usbcamdi.h)

Siehe auch

CamAllocateBandwidthEx

KS_DATAFORMAT_VIDEOINFOHEADER

USBCAMD_SelectAlternateInterface