次の方法で共有

IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS IOCTL (winbio_ioctl.h)

  • [アーティクル]

IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS IOCTL は、デバイスでサポートされている暗号化ハッシュ アルゴリズムの一覧を取得します。 この IOCTL は省略可能です。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

[なし] :

入力バッファーの長さ

[なし] :

出力バッファー

AssociatedIrp。SystemBuffer メンバーは、WINBIO_SUPPORTED_ALGORITHMS構造体を含むバッファーを指します。

出力バッファーの長さ

有効な出力バッファー サイズの最小は、DWORD のサイズです。 ドライバーが DWORD サイズの出力バッファーを受け取った場合、ドライバーは要求された操作に必要なバッファー サイズを返す必要があります。

ステータス ブロック

ドライバーへの DeviceIoControl 呼び出しが完了し、OUT ペイロードが有効かどうかを示します。

Status メンバーは、次の表のいずれかの値に設定されます。

ステータス値 説明
S_OK、STATUS_SUCCESS 操作は正常に完了しました。 返されるデータのサイズが DWORD の場合、ペイロードには呼び出しに必要なバッファーのサイズが含まれます。 それ以外の場合、ペイロードには完全な出力バッファーが含まれます。
E_INVALIDARG パラメーターが正しく指定されていません。
E_UNKNOWN ペイロードの入力を妨げるその他のエラー。
E_UNEXPECTED ペイロードの入力を妨げるその他のエラー。
E_FAIL ペイロードの入力を妨げるその他のエラー。

注釈

アルゴリズムは、NULL で終わる UTF-8 エンコード文字列を使用して指定されます。 アルゴリズム識別子 "OID" 文字列は、RFC 3279 および RFC 3278 で定義されています。

ハッシュ アルゴリズムの OID 文字列の例を次に示します。

アルゴリズム アルゴリズム識別子の文字列
SHA-1 "1.3.14.3.2.26"
SHA-256 "2.16.840.1.101.3.4.2.1"
SHA-384 "2.16.840.1.101.3.4.2.2"
SHA-512 "2.16.840.1.101.3.4.2.3"

デバイスがWINBIO_CAPABILITY_SECURE_STORAGEをサポートしている場合は、IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMSを実装する必要があります。 デバイスでは、WinBio テンプレートの格納に使用する SHA-1 ("1.3.14.3.2.26") 以上がサポートされている必要があります。

ベンダーが指定したドライバーがペイロード全体を渡す場合は、WINBIO_SUPPORTED_ALGORITHMSの WinBioHresult メンバーに生体認証操作の状態を入力する必要があります。

次の値を指定できます。

要件

要件 値
サポートされている最小のクライアント Windows 7 以降のバージョンの Windows で使用できます。
Header winbio_ioctl.h