Benutzerdefinierte Steuerelementcodes

Anbieter können benutzerdefinierte Steuerungscodes ab 0x800 definieren.

Verwenden Sie zum Definieren herstellerspezifischer E/A-Steuerungscodes das vom System bereitgestellte makro CTL_CODE mit den folgenden Argumenten:

#define IOCTL_BIOMETRIC_Device_Function CTL_CODE(FILE_DEVICE_BIOMETRIC, Function, METHOD_BUFFERED, FILE_ANY_ACCESS)

Alle Eingabe-/Ausgabeparameter sind herstellerdefiniert. Der Status-Member ist auf einen der Werte in der folgenden Tabelle festgelegt:

Statuswert	BESCHREIBUNG
S_OK, STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen. Wenn die Größe der zurückgegebenen Daten DWORD ist, enthält die Nutzlast die Größe des Puffers, der für den Aufruf erforderlich ist. Andernfalls enthält die Nutzlast den vollständigen Ausgabepuffer.
E_INVALIDARG	Die Parameter wurden nicht ordnungsgemäß angegeben.

Anbieterdefinierte IOCTLs können für alle herstellerspezifischen Vorgänge verwendet werden. Diese Aufrufe erfolgen über den Windows-Biometrischen Dienst, der die exklusive Kontrolle über das Gerät hat. Hier finden Sie einige Beispiele dafür, wie Anbieter die anbieterspezifischen IOCTLs verwenden können:

• Richten Sie proprietäre sichere Sitzungen zwischen einer Anwendung oder Komponente und dem Gerät ein.
• Schnittstelle mit Abgleichs- und Speicherfunktionen auf dem Gerät über eine WinBio-Engine oder ein Datenbank-Plug-In.
• Stift-E/A für herstellerspezifische Geräteereignisse.
• Verwalten von anbieterspezifischen Sitzungen.

Dieses Feature ist in Windows 7 und höheren Versionen von Windows verfügbar.