EVT_MBB_DEVICE_SEND_DEVICE_SERVICE_SESSION_DATA fonction de rappel (mbbcx.h)

Article
02/27/2024

La fonction de rappel d’événement EvtMbbDeviceSendServiceSessionData d’un pilote client envoie les données de session du service d’appareil à son appareil modem.

Syntaxe

EVT_MBB_DEVICE_SEND_DEVICE_SERVICE_SESSION_DATA EvtMbbDeviceSendDeviceServiceSessionData;

void EvtMbbDeviceSendDeviceServiceSessionData(
  WDFDEVICE Device,
  DSS_SESSION_ID SessionId,
  WDFMEMORY Data
)
{...}

Paramètres

Device

Handle pour un objet d’appareil framework que le pilote client a obtenu à partir d’un appel précédent à WdfDeviceCreate.

SessionId

ID de la session de service d’appareil obtenue à partir d’un appel précédent à MbbAdapterGetSessionId.

Data

Objet WDFMEMORY contenant les données à transmettre à l’appareil.

Valeur de retour

None

Remarques

MBBCx appelle la fonction de rappel EvtMbbDeviceSendServiceSessionData d’un pilote client lorsqu’une application envoie des données DSS au périphérique modem. Après avoir envoyé les données à l’appareil de manière asynchrone, le pilote client doit appeler MbbDeviceSendServiceSessionDataComplete afin que MBBCx puisse libérer la mémoire allouée pour les données.

Exemple

L’exemple suivant montre comment un client peut envoyer des données DSS à son appareil modem. La gestion des erreurs a été laissée en dehors de cet exemple pour des raisons de concision et de clarté.

VOID
MyEvtMbbDeviceSendServiceSessionData(
    _In_ WDFDEVICE Device,
    _In_ DSS_SESSION_ID SessionId,
    _In_ WDFMEMORY Data
)
{
    // Get the device context and NETADAPTER context
    PMY_DEVICE_CONTEXT deviceContext = GetMyDeviceContext(Device);

    // Set up a driver-defined DSS packet structure
    PMY_DSS_PACKET packet = NULL;

    // Get the data to send from the WDFMEMORY object
    size_t bufferSize = 0;
    PVOID buffer = WdfMemoryGetBuffer(Data, 
                                      &bufferSize);

    // Populate the DSS packet
    packet = MyAllocateDssPacket(Data,
                                buffer,
                                bufferSize,
                                SessionId);

    // Send the data asynchronously, which returns STATUS_PENDING when successful
    status = MyModemBusWriteData(deviceContext->BusHandle,
                                 packet);

    // Increment count of sent packets
    deviceContext->DSSPacketsSentCount++;

    // Clean up the memory
    MbbDeviceSendServiceSessionDataComplete(Data,
                                            status);
    MyCleanupDssPacket(packet);
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1809
Plateforme cible	Universal
Version KMDF minimale	1,27 %
En-tête	mbbcx.h
IRQL	PASSIVE_LEVEL

Partager via