Condividi tramite


IOCTL_NFCSE_ENUM_ENDPOINTS IOCTL (nfcsedev.h)

Restituisce informazioni relative all'elenco di tutti gli elementi protetti collegati al controller NFC. Si noti che il chiamante deve allocare un buffer di output sufficientemente grande per contenere informazioni relative a tutti gli elementi sicuri enumerati dal driver, ad esempio il numero totale di SEs Enumerated x Size delle informazioni sull'endpoint SE; in caso contrario, il driver deve restituire un codice di errore STATUS_BUFFER_OVERFLOW al client con il campo NumberOfEndpoints contenente il numero di elementi sicuri enumerati. GUID che identifica l'elemento sicuro che può essere usato per fare riferimento a un particolare elemento sicuro.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Nessuno

Lunghezza del buffer di input

Nessuno

Buffer di output

Un SECURE_ELEMENT_ENDPOINT_LIST per ogni dispositivo enumerato.

Blocco dello stato

Irp->IoStatus.Status è impostato su STATUS_SUCCESS se la richiesta ha esito positivo. I codici di errore possibili sono:

Codice restituito Descrizione
STATUS_INVALID_PARAMETER Questo codice viene restituito quando il buffer di output è diverso da zero.
STATUS_BUFFER_OVERFLOW Il buffer fornito era troppo piccolo per ricevere la configurazione della tabella di routing.

Commenti

Di seguito sono riportati i requisiti che il driver deve rispettare.

  • Nel caso di un elemento protetto integrato, il GUID deve essere un identificatore univoco derivato dal numero di serie e/o da un'altra identificazione univoca dell'elemento protetto.
  • Per gli elementi protetti esterni, il GUID può essere una costante fissa e identifica solo il "socket" in cui è connesso l'elemento sicuro.
  • Per l'elemento protetto dell'host del dispositivo, il driver lo enumera come endpoint SE solo se supporta l'emulazione della scheda host. GUID usato per DH forse una costante fissa definita dal driver.
  • Il chiamante deve allocare un buffer di output sufficientemente grande per contenere le informazioni su tutti gli elementi sicuri enumerati dal driver. Il buffer deve essere uguale al numero totale di SEs enumerati dal driver moltiplicato per le dimensioni delle informazioni sull'endpoint SE. Se il buffer appropriato non è allocato, il driver restituisce un codice di errore STATUS_BUFFER_OVERFLOW al client con il campo NumberOfEndpoints che contiene il numero di elementi sicuri enumerati.

Requisiti

Requisito Valore
Intestazione nfcsedev.h