Partager via

IMbnDeviceService::WriteData, méthode (mbnapi.h)

  • Article

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
S_OK
 La commande s'est correctement terminée.
E_ACCESSDENIED
 Cette commande de service d’appareil n’est pas autorisée pour appeler des privilèges de processus.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
 La longueur de deviceServiceData est supérieure à la maxDataSize prise en charge.
HRESULT_FROM_WIN32(ERROR_OPEN_FAILED)
 La session de service d’appareil n’est pas ouverte.
Autres
 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

Voir aussi

IMbnDeviceService