IMbnDeviceService::WriteData, méthode (mbnapi.h)
Important
À compter de Windows 10, version 1803, les API Win32 décrites dans cette section sont remplacées par les API Windows Runtime dans l’espace de noms Windows.Networking.Connectivity.
Écrire des données dans une session de données de service d’appareil.
Syntaxe
HRESULT WriteData(
[in] SAFEARRAY *deviceServiceData,
[out] ULONG *requestID
);
Paramètres
[in] deviceServiceData
Tableau d’octets transmis à l’appareil à écrire.
[out] requestID
ID de demande unique attribué par le service Haut débit mobile pour identifier cette demande.
Valeur retournée
La méthode peut retourner l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. |
|
Cette commande de service d’appareil n’est pas autorisée pour appeler des privilèges de processus. |
|
La longueur de deviceServiceData est supérieure à la maxDataSize prise en charge. |
|
La session de service d’appareil n’est pas ouverte. |
|
Une erreur s’est produite lors de l’exécution de cette méthode. |
Notes
WriteData transmet des données en bloc à un service d’appareil spécifique au fournisseur sur l’appareil. Le service Haut débit mobile transfère cette demande à l’appareil. deviceServiceData sera copié octet par octet dans la mémoire tampon de données transmise à la requête. Cette mémoire tampon de données doit être inférieure à maxDataSize octets.
La session de données doit être ouverte avant que l’application puisse appeler WriteData. Le système d’exploitation ne fournit pas de garanties sur la latence ou les performances de WriteData.
Il s’agit d’une opération asynchrone et WriteData retourne immédiatement. À l’issue de l’opération, le service Haut débit mobile appelle la méthode OnWriteDataComplete de l’interface IMbnDeviceServicesEvents .
Configuration requise
| Plateforme cible | Windows |
| En-tête | mbnapi.h |