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 oggetto BTH_SDP_ATTRIBUTE_SEARCH_REQUEST struttura che specifica l'intervallo di attributi del computer remoto in cui eseguire la ricerca 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 di stato
Se la richiesta ha esito positivo, il membro informazioni della struttura STATUS_BLOCK viene impostato sulle dimensioni, in byte, dell'BTH_SDP_STREAM_RESPONSE o sulle 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 è stato 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. |
Osservazioni
Nella maggior parte dei casi, i driver di profilo possono combinare ricerche di attributi e servizio SDP chiamando IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL. Se un driver di 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 (MTU), il driver del profilo deve chiamare il IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL per eseguire una ricerca nel servizio. Il driver del profilo deve quindi chiamare il IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL per eseguire una ricerca di attributi.
La struttura BTH_SDP_STREAM_RESPONSE restituita nel buffer di output contiene informazioni sulle dimensioni dell'intero record SDP, le dimensioni, in byte, del flusso di record SDP non elaborato che segue la struttura BTH_SDP_STREAM_RESPONSE e il primo byte del flusso. Il flusso a lunghezza variabile è costituito dagli attributi del record SDP restituiti dalla ricerca.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Versioni:_Supported in Windows Vista e versioni successive. |
| intestazione | bthioctl.h (include Bthioctl.h) |
| IRQL | <= PASSIVE_LEVEL |