IOCTL_NFCSE_ENUM_ENDPOINTS IOCTL (nfcsedev.h)

  • Artikel

Gibt Informationen über die Liste aller sicheren Elemente zurück, die an den NFC-Controller angefügt sind. Beachten Sie, dass der Aufrufer einen Ausgabepuffer zuordnen muss, der groß genug ist, um Informationen zu allen sicheren Elementen zu enthalten, die vom Treiber aufgezählt wurden, d. h. Gesamtanzahl der SEs Enumerated x Size der SE-Endpunktinformationen, andernfalls sollte der Treiber einen STATUS_BUFFER_OVERFLOW Fehlercode an den Client mit dem Feld NumberOfEndpoints zurückgeben, das die Anzahl der aufgezählten sicheren Elemente enthält. Die GUID, die das sichere Element identifiziert, das möglicherweise verwendet wird, um auf ein bestimmtes sicheres Element zu verweisen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine

Länge des Eingabepuffers

Keine

Ausgabepuffer

Ein SECURE_ELEMENT_ENDPOINT_LIST für jedes aufgezählte Gerät.

Statusblock

Irp->IoStatus.Status ist auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Mögliche Fehlercodes sind:

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER Dieser Code wird zurückgegeben, wenn der Ausgabepuffer ungleich 0 (null) ist.
STATUS_BUFFER_OVERFLOW Der bereitgestellte Puffer war zu klein, um die Routingtabellenkonfiguration zu empfangen.

Hinweise

Im Folgenden sind Die Anforderungen aufgeführt, die der Treiber erfüllen muss.

  • Im Falle eines integrierten sicheren Elements muss die GUID ein eindeutiger Bezeichner sein, der von der Seriennummer und/oder einer anderen eindeutigen Identifizierung des sicheren Elements abgeleitet ist.
  • Bei externen sicheren Elementen ist die GUID möglicherweise eine feste Konstante und identifiziert nur den "Socket", mit dem das sichere Element verbunden ist.
  • Für ein sicheres Element des Gerätehosts muss der Treiber es nur dann als SE-Endpunkt aufzählen, wenn die Hostkartenemulation unterstützt wird. Die für DH verwendete GUID ist möglicherweise eine feste Konstante, die vom Treiber definiert wird.
  • Der Aufrufer muss einen Ausgabepuffer zuordnen, der groß genug ist, um die Informationen zu allen sicheren Elementen zu enthalten, die vom Treiber aufgelistet wurden. Der Puffer muss gleich der Gesamtanzahl von SEs sein, die vom Treiber multipliziert mit der Größe der SE-Endpunktinformationen aufgezählt werden. Wenn der entsprechende Puffer nicht zugeordnet ist, gibt der Treiber einen STATUS_BUFFER_OVERFLOW Fehlercode an den Client mit dem Feld NumberOfEndpoints zurück, das die Anzahl der aufgezählten sicheren Elemente enthält.

Anforderungen

Anforderung Wert
Header nfcsedev.h