IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)
La richiesta di IOCTL_BTH_SDP_ATTRIBUTE_SEARCH ottiene gli attributi per il record SDP specificato.
Codice principale
Buffer di input
Il membro AssociatedIrp.SystemBuffer contiene un BTH_SDP_ATTRIBUTE_SEARCH_REQUEST struttura che specifica l'intervallo di attributi del computer remoto da cercare e altri membri chiave.
Lunghezza del buffer di input
Lunghezza di un oggetto BTH_SDP_ATTRIBUTE_SEARCH_REQUEST struttura.
Buffer di output
Il membro AssociatedIrp.SystemBuffer punta a un buffer contenente una struttura BTH_SDP_STREAM_RESPONSE seguita da un flusso SDP non elaborato a lunghezza variabile.
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 è impostato sulle dimensioni, in byte, dell'BTH_SDP_STREAM_RESPONSE o delle dimensioni del buffer di output, che tuttavia è più piccolo. In caso contrario, il membro Information è 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
Nella maggior parte dei casi, i driver del profilo possono combinare il servizio SDP e le ricerche degli attributi chiamando il IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL. Se un driver del profilo deve ridurre la quantità di traffico SDP trasmesso tramite il collegamento Bluetooth o estrarre informazioni dal server SDP usando un numero ridotto di unità di trasferimento messaggi (MTUS), il driver del profilo deve chiamare il IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL per eseguire una ricerca del servizio. Il driver del profilo deve quindi chiamare il IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL per eseguire una ricerca degli attributi.
La struttura BTH_SDP_STREAM_RESPONSE restituita nel buffer di output contiene informazioni sulle dimensioni dell'intero record SDP, sulle dimensioni, in byte, del flusso di record SDP non elaborato che segue la struttura BTH_SDP_STREAM_RESPONSE e il primo byte di tale flusso. Il flusso a lunghezza variabile è gli attributi di record SDP restituiti dalla ricerca.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Versioni:_Supported in Windows Vista e versioni successive. |
| Intestazione | bthioctl.h (include Bthioctl.h) |
| IRQL | <= PASSIVE_LEVEL |