IOCTL_NFCSE_ENUM_ENDPOINTS IOCTL (nfcsedev.h)

Gibt Informationen zur Liste aller sicheren Elemente zurück, die mit dem NFC-Controller verbunden sind. Beachten Sie, dass der Aufrufer einen Ausgabepuffer groß genug zuweisen muss, um Informationen zu allen sicheren Elementen zu enthalten, die vom Treiber aufgezählt wurden, d. h. die Gesamtanzahl der aufgezählten 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

Nichts

Eingabepufferlänge

Nichts

Ausgabepuffer

Eine SECURE_ELEMENT_ENDPOINT_LIST für jedes Aufzählungsgerät.

Statusblock

Irp->IoStatus.Status wird 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 Null ist.
STATUS_BUFFER_OVERFLOW	Der bereitgestellte Puffer war zu klein, um die Routingtabellenkonfiguration zu empfangen.

Bemerkungen

Im Folgenden sind die Anforderungen aufgeführt, die der Treiber einhalten muss.

• Bei integrierten sicheren Elementen muss die GUID ein eindeutiger Bezeichner sein, der von der Seriennummer und/oder einer anderen eindeutigen Identifikation 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 das sichere Element des Gerätehosts muss der Treiber es nur dann als SE-Endpunkt aufzählen, wenn es die Hostkartenemulation unterstützt. Die für DH verwendete GUID ist möglicherweise eine feste Konstante, die vom Treiber definiert wird.
• Der Aufrufer ist erforderlich, um einen Ausgabepuffer groß genug zuzuweisen, um die Informationen zu allen sicheren Elementen zu enthalten, die vom Treiber aufgezählt wurden. Der Puffer muss der Gesamtzahl der SEs entsprechen, die vom Treiber aufgezählt werden, multipliziert mit der Größe der SE-Endpunktinformationen. Wenn der entsprechende Puffer nicht zugeordnet ist, gibt der Treiber einen STATUS_BUFFER_OVERFLOW Fehlercode mit dem Feld "NumberOfEndpoints" zurück, das die Anzahl der aufgezählten sicheren Elemente enthält.

Anforderungen

Anforderung	Wert
Header-	nfcsedev.h