IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)
La richiesta di IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH combina un servizio SDP e la ricerca di attributi in una singola operazione. In questo modo un chiamante può ottenere direttamente i record SDP da un dispositivo remoto.
Codice principale
Buffer di input
Il membro AssociatedIrp.SystemBuffer contiene un oggetto IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH struttura che specifica l'handle di connessione al server SDP remoto, una matrice di GUID e l'intervallo di valori di attributo da cercare.
Lunghezza del buffer di input
Lunghezza di un oggetto IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH struttura.
Buffer di output
Il membro AssociatedIrp.SystemBuffer punta a un buffer che contiene una struttura BTH_SDP_STREAM_RESPONSE seguita da un flusso di record SDP non elaborato.
Lunghezza del buffer di output
Lunghezza di una struttura BTH_SDP_STREAM_RESPONSE .
Blocco dello stato
Se la richiesta ha esito positivo, il membro Informazioni della struttura STATUS_BLOCK viene impostato sulle dimensioni, in byte, del flusso di risposta SDP o delle dimensioni del buffer di output, a qualsiasi valore inferiore. In caso contrario, il membro Informazioni è impostato su zero.
Il membro Status è impostato su uno dei valori della tabella seguente.
| Valore di stato | Descrizione |
|---|---|
| STATUS_SUCCESS | L'IOCTL è stato completato correttamente. |
| STATUS_DEVICE_NOT_CONNECTED | Il dispositivo in cui risiede il servizio SDP non è connesso. |
| STATUS_INSUFFICIENT_RESOURCES | Memoria insufficiente per completare questa operazione. |
| STATUS_INVALID_BUFFER_SIZE | Il buffer di output è stato ridimensionato in modo errato. |
| STATUS_INVALID_PARAMETER | Uno dei valori nel buffer di input non è valido. |
| STATUS_REQUEST_NOT_ACCEPTED | Il servizio SDP ha rifiutato la richiesta. |
| STATUS_TOO_MANY_GUIDS_REQUESTED | Il servizio SDP non è riuscito a elaborare il numero di GUID passati nel buffer di input. |
Commenti
Dopo che un driver di profilo ottiene un record SDP, può usare le funzioni SDP per analizzarle. I puntatori a queste funzioni vengono forniti da interfaccia BTHDDI_SDP_PARSE_INTERFACE .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Versioni:_Supported in Windows Vista e versioni successive. |
| Intestazione | bthioctl.h (include Bthioctl.h) |
| IRQL | <= PASSIVE_LEVEL |