IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL (winbio_ioctl.h)
Die IOCTL_BIOMETRIC_CAPTURE_DATA IOCTL weist den Treiber an, den nächsten Scan biometrischer Daten abzurufen. Durch diesen Aufruf sollte das Gerät in den Aufnahmemodus versetzt werden. Vom Anbieter bereitgestellte WBDI-Treiber müssen IOCTL_BIOMETRIC_CAPTURE_DATA unterstützen.
Hauptcode
Eingabepuffer
Länge des Eingabepuffers
Die Länge einer WINBIO_CAPTURE_PARAMETERS-Struktur .
Ausgabepuffer
AssociatedIrp. SystemBuffer-Member zeigt auf einen Puffer, der eine WINBIO_CAPTURE_DATA-Struktur enthält.
Die anbieterspezifischen Daten in der WINBIO_BIR-Struktur können in einem beliebigen Format vorliegen, das der Anbieter vom Treiber erfassen möchte. Anbieter können daten im WBDI-Treiber oder im Engine-Adapter verarbeiten, aber die Daten müssen in einer Einzigen Struktur übergeben werden.
Länge des Ausgabepuffers
Die kleinste gültige Ausgabepuffergröße ist die Größe von DWORD.
Wenn der Treiber einen Ausgabepuffer im DWORD-Format empfängt, muss der Treiber sofort die Puffergröße zurückgeben, die zum Abschließen des Vorgangs erforderlich ist. Warten Sie nicht, bis die Wischbewegung erfolgt, um die erforderliche Puffergröße zu senden.
Statusblock
Gibt an, ob der DeviceIoControl-Aufruf des Treibers abgeschlossen wurde und die OUT-Nutzlast gültig ist.
Das Status-Element wird 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. |
| WINBIO_E_DATA_COLLECTION_IN_PROGRESS | Das Gerät hat eine IOCTL_BIOMETRIC_CAPTURE_DATA ausstehend. |
| E_UNKNOWN | Alle anderen Fehler, die verhindern, dass die Nutzlast ausgefüllt wird. |
| E_UNEXPECTED | Alle anderen Fehler, die verhindern, dass die Nutzlast ausgefüllt wird. |
| E_FAIL | Alle anderen Fehler, die verhindern, dass die Nutzlast ausgefüllt wird. |
Hinweise
Es kann jederzeit nur eine Datensammlungs-IOCTL ausstehen. Wenn auf dem Gerät eine IOCTL_BIOMETRIC_CAPTURE_DATA aussteht, müssen IOCTL_BIOMETRIC_CAPTURE_DATA WINBIO_E_DATA_COLLECTION_IN_PROGRESS zurückgeben.
IOCTL_BIOMETRIC_CAPTURE_DATA ist eine blockierende Datensammlungs-IOCTL, die abgeschlossen wird, wenn die biometrische Datenerfassung erfolgt.
Wenn der vom Anbieter bereitgestellte Treiber die gesamte Nutzlast zurückgibt, sollte er das WinBioHresult-Element von WINBIO_CAPTURE_DATA mit dem status des biometrischen Vorgangs ausfüllen.
Mögliche Werte sind:
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | winbio_ioctl.h |