IOCTL_GNSS_CONFIG_SUPL_CERT IOCTL (gnssdriver.h)
IOCTL_GNSS_CONFIG_SUPL_CERT制御コードは、GNSS アダプターによって SUPL 証明書を設定するために使用されます。
メジャー コード
[入力バッファー]
GNSS_SUPL_CERT_CONFIG構造体へのポインター。
入力バッファーの長さ
sizeof(GNSS_SUPL_CERT_CONFIG) に設定します。
出力バッファー
NULL に設定します。
出力バッファーの長さ
0 に設定されます。
ステータス ブロック
Irp->要求が成功した場合、IoStatus.Status はSTATUS_SUCCESSに設定されます。 それ以外の場合は、NTSTATUS コードとして適切なエラー条件に対する状態。
注釈
ドライバーは、次のいずれかの NTSTATUS 値を設定して結果を示します。
- STATUS_SUCCESS、ドライバーが SUPL 証明書情報を正常に処理するとします。 IOCTL が存在しない証明書を削除または消去しようとすると、STATUS_SUCCESSが返されます。
- ドライバーが SUPL 証明書情報を正常に処理しない場合、失敗しました。
- ドライバーが SUPL 証明書情報を無視する場合は無視されます。
GNSS アダプターに関するメモ
GNSS DDI バージョン 1 の場合:GNSS アダプターは特別な操作を行う必要はありません。
GNSS DDI バージョン 2 以降の場合:
GNSS アダプターは、名前によってのみ証明書を参照します。 必要に応じて、証明書名を他の表現または証明書への参照に内部的にマップするのは GNSS ドライバーにかかるでしょう。
GNSS アダプターは、新しいセットを挿入する前に、必要に応じて、完全消去または以前に挿入されたすべての証明書を実行します。
GNSS ドライバー ノート
GNSS ドライバーは、証明書を使用して H-SLP とのセキュリティで保護された接続を設定する必要がある SUPL コンポーネントにこの証明書情報を渡す必要があります。GNSS DDI バージョン 2 以降の場合:
GNSS ドライバーは、 IOCTL_GNSS_CONFIG_SUPL_CERTの複数の呼び出しの受信をサポートする必要があります。 GNSS アダプターは、この IOCTL を複数回呼び出して、毎回異なるルート証明書を挿入します。 異なるルート証明書は、挿入される証明書の名前を提供する別の SuplCertName を持つことによって識別されます。
- 名前が以前に構成された証明書と同じ場合は、証明書が置き換えられます。
- 名前が証明書と異なる場合は、新しい証明書が追加されます。
要件
| 要件 | 値 |
|---|---|
| Header | gnssdriver.h |
こちらもご覧ください
WdfIoTargetSendInternalIoctlOthersSynchronously