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
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 |