_BRB_GET_DEVICE_INTERFACE_STRING struttura (bthddi.h)

La struttura _BRB_GET_DEVICE_INTERFACE_STRING descrive la stringa dell'interfaccia del dispositivo per l'oggetto dispositivo corrente.

Sintassi

struct _BRB_GET_DEVICE_INTERFACE_STRING {
  BRB_HEADER Hdr;
  PWCHAR     DeviceInterfaceString;
  ULONG      DeviceInterfaceStringCbLength;
};

Members

Hdr

Struttura BRB_HEADER contenente informazioni sulla BRB corrente.

DeviceInterfaceString

Puntatore al buffer per contenere la stringa dell'interfaccia del dispositivo.

DeviceInterfaceStringCbLength

In input, questo membro specifica la lunghezza, espressa in byte, della stringa dell'interfaccia del dispositivo. Nell'output, questo membro specifica il numero di byte necessari per la stringa se BRB_GET_DEVICE_INTERFACE_STRING BRB ha esito negativo e restituisce STATUS_MORE_ENTRIES a causa della lunghezza del buffer insufficiente. Se la chiamata BRB ha esito positivo, questo membro contiene il numero di byte copiati.

Commenti

Per ottenere la stringa dell'interfaccia del dispositivo per l'oggetto dispositivo corrente, i driver del profilo devono compilare e inviare un BRB_GET_DEVICE_INTERFACE_STRING richiesta.

Lo stack di driver Bluetooth esegue una chiamata IoRegisterDeviceInterface su ogni oggetto dispositivo creato. BRB restituisce la stringa dell'interfaccia del dispositivo restituita da tale chiamata. Questo può essere utile per la registrazione per gli eventi.

Se il buffer a cui punta il membro DeviceInterfaceString non è sufficiente per contenere la stringa, la chiamata ha esito negativo e il membro DeviceInterfaceStringCbLength contiene la lunghezza del buffer necessaria.

Requisiti

Vedi anche

BRB_HEADER

IoRegisterDeviceInterface