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) |