Share via


IOCTL_NFP_GET_KILO_BYTES_PER_SECOND IOCTL (nfpdev.h)

Ein Client sendet die IOCTL_NFP_GET_KILO_BYTES_PER_SECOND Anforderung an ein beliebiges generisches Handle, das nicht veröffentlicht und nicht abonniert ist, an das Anbietergerät. Die Anforderung wird gesendet, um die ungefähre Übertragungsgeschwindigkeit im besten Fall zu ermitteln, die vom Anbieter oder seiner zugrunde liegenden RF-Technologie unterstützt wird. Dies wird verwendet, um den Unterschied in einer Größenordnung der Übertragungsrate zu einer anderen zu unterscheiden.

Hinweis Eine typische NFC-Implementierung sollte einen Wert von ungefähr 50 bereitstellen.
 

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine

Ausgabepuffer

Ein INT32-Wert , der die ungefähre Übertragungsgeschwindigkeit definiert, die vom Anbieter oder seiner zugrunde liegenden Technologie unterstützt wird.

Statusblock

Irp-IoStatus.Status> wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist.

Andernfalls wird Status zur entsprechenden Fehlerbedingung als NTSTATUS-Code verwendet.

Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

Jede Anbieterimplementierung kann eine ungefähre Übertragungsrate angeben. Eine typische NFC-Implementierung sollte einen Wert von etwa 50 KB pro Sekunde bereitstellen.

Bei Verwendung dieser IOCTL sind folgende Aktionen erforderlich:

  • Der Treiber MUSS eine ungefähre Übertragungsrate von nicht weniger als 16 KB pro Sekunde unterstützen.
  • Wenn diese IOCTL empfangen wird, MUSS der Treiber die ungefähre Übertragungsgeschwindigkeit in den Ausgabepuffer kopieren und mit STATUS_SUCCESS abschließen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Kopfzeile nfpdev.h

Weitere Informationen

Allgemeine Entwurfsanleitung für Near Field Communication (NFC)

Entwurfsleitfaden für Nahfeldnähe (Tippen und Tun, NFP-Anbietermodell, Treiberanforderungen)