次の方法で共有

IOCTL_NFCSE_ENUM_ENDPOINTS IOCTL (nfcsedev.h)

  • [アーティクル]

NFC コントローラーに接続されているすべてのセキュリティで保護された要素の一覧に関する情報を返します。 呼び出し元は、ドライバーによって列挙されたすべてのセキュリティで保護された要素に関する情報を保持するのに十分な大きさの出力バッファーを割り当てる必要があることに注意してください。つまり、SE エンドポイント情報の列挙 x サイズの合計数。それ以外の場合、ドライバーは列挙されたセキュリティで保護された要素の数を含む NumberOfEndpoints フィールドを持つSTATUS_BUFFER_OVERFLOWエラー コードをクライアントに返す必要があります。 特定のセキュリティで保護された要素を参照するために使用されるセキュリティで保護された要素を識別する GUID。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

なし

入力バッファーの長さ

なし

出力バッファー

列挙された各デバイスの SECURE_ELEMENT_ENDPOINT_LIST 。

ステータス ブロック

Irp->要求が成功した場合、IoStatus.Status は STATUS_SUCCESS に設定されます。 考えられるエラー コードは次のとおりです。

リターン コード 説明
STATUS_INVALID_PARAMETER このコードは、出力バッファーが 0 以外の場合に返されます。
STATUS_BUFFER_OVERFLOW 指定されたバッファーが小さすぎてルーティング テーブル構成を受信できませんでした。

注釈

ドライバーが準拠する必要がある要件を次に示します。

  • 統合されたセキュリティで保護された要素の場合、GUID はシリアル番号から派生した一意識別子、またはセキュリティで保護された要素のその他の一意の識別である必要があります。
  • 外部のセキュリティで保護された要素の場合、GUID は固定定数である可能性があり、secure 要素が接続されている "ソケット" のみを識別します。
  • デバイス ホストセキュリティで保護された要素の場合、ドライバーは、ホスト カード エミュレーションをサポートしている場合にのみ、SE エンドポイントとして列挙する必要があります。 DH に使用される GUID は、ドライバーによって定義された固定定数である可能性があります。
  • 呼び出し元は、ドライバーによって列挙されたすべてのセキュリティで保護された要素に関する情報を保持するのに十分な大きさの出力バッファーを割り当てる必要があります。 バッファーは、ドライバーで列挙された SE の合計数に SE エンドポイント情報のサイズを乗算した値に等しい必要があります。 適切なバッファーが割り当てられていない場合、ドライバーは、列挙されたセキュリティで保護された要素の数を含む NumberOfEndpoints フィールドを使用して、STATUS_BUFFER_OVERFLOWエラー コードをクライアントに返します。

要件

要件 値
Header nfcsedev.h