NFC コントローラーに接続されているすべてのセキュリティで保護された要素の一覧に関する情報を返します。 呼び出し元は、ドライバーによって列挙されたすべてのセキュリティで保護された要素に関する情報を保持するのに十分な大きさの出力バッファーを割り当てる必要があることに注意してください。つまり、SE エンドポイント情報の SEs 列挙 x サイズの合計数。それ以外の場合、ドライバーは、列挙されたセキュリティで保護された要素の数を含む NumberOfEndpoints フィールドを持つSTATUS_BUFFER_OVERFLOWエラー コードをクライアントに返す必要があります。 特定のセキュリティで保護された要素を参照するために使用される可能性があるセキュリティで保護された要素を識別する GUID。
メジャー コード
入力バッファー
何一つ
入力バッファーの長さ
何一つ
出力バッファー
列挙された各デバイスの SECURE_ELEMENT_ENDPOINT_LIST。
状態ブロック
Irp->IoStatus.Status は、要求が成功した場合に STATUS_SUCCESS に設定されます。 考えられるエラー コードは次のとおりです。
| リターン コード | 形容 |
|---|---|
| STATUS_INVALID_PARAMETER | このコードは、出力バッファーが 0 以外の場合に返されます。 |
| STATUS_BUFFER_OVERFLOW | 指定されたバッファーが小さすぎてルーティング テーブルの構成を受信できませんでした。 |
備考
ドライバーが準拠する必要がある要件を次に示します。
- 統合されたセキュリティで保護された要素の場合、GUID は、シリアル番号またはセキュリティで保護された要素の他の一意の識別から派生した一意の識別子である必要があります。
- 外部のセキュリティで保護された要素の場合、GUID は固定定数である可能性があり、セキュリティで保護された要素が接続されている "ソケット" のみを識別します。
- デバイス ホストのセキュリティで保護された要素の場合、ドライバーは、ホスト カード エミュレーションをサポートしている場合にのみ、SE エンドポイントとして列挙する必要があります。 DH に使用される GUID は、ドライバーによって定義された固定定数である可能性があります。
- 呼び出し元は、ドライバーによって列挙されたすべてのセキュリティで保護された要素に関する情報を保持するのに十分な大きさの出力バッファーを割り当てる必要があります。 バッファーは、ドライバーで列挙された SE の合計数に SE エンドポイント情報のサイズを乗算した値に等しい必要があります。 適切なバッファーが割り当てられていない場合、ドライバーは列挙されたセキュリティで保護された要素の数を含む NumberOfEndpoints フィールドを使用して、STATUS_BUFFER_OVERFLOWエラー コードをクライアントに返します。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | nfcsedev.h |