USBDevice: Methode controlTransferIn()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die controlTransferIn() Methode des USBDevice-Interfaces gibt ein Promise zurück, das mit einem USBInTransferResult aufgelöst wird, wenn ein Befehl oder Statusanforderung an das USB-Gerät übertragen wurde (und vom Gerät empfangen wurde).

Syntax

js
controlTransferIn(setup, length)

Parameter

setup

Ein Objekt, das Optionen festlegt. Die verfügbaren Optionen sind:

requestType

Muss einer von drei Werten sein, die angeben, ob die Übertragung "standard" (häufig bei allen USB-Geräten), "class" (häufig bei einer nach Industriestandards festgelegten Geräteklasse) oder "vendor" ist.

recipient

Gibt das Ziel der Übertragung auf dem Gerät an, eines von "device", "interface", "endpoint", oder "other".

request

Ein herstellerspezifischer Befehl.

value

Herstellerspezifische Anforderungsparameter.

index

Die Schnittstellennummer des Empfängers.

length

Die maximale Anzahl von Bytes, die vom Gerät gelesen werden sollen. Die tatsächlichen Daten befinden sich im USBInTransferResult im aufgelösten Promise.

Rückgabewert

promise das mit einem USBInTransferResult aufgelöst wird.

Spezifikationen

Specification
WebUSB API
# ref-for-dom-usbdevice-controltransferin

Browser-Kompatibilität

BCD tables only load in the browser