EVT_MBB_DEVICE_SEND_DEVICE_SERVICE_SESSION_DATA コールバック関数 (mbbcx.h)

クライアント ドライバーの EvtMbbDeviceSendServiceSessionData イベント コールバック関数は、デバイス サービス セッション データをモデム デバイスに送信します。

構文

EVT_MBB_DEVICE_SEND_DEVICE_SERVICE_SESSION_DATA EvtMbbDeviceSendDeviceServiceSessionData;

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

パラメーター

Device

WdfDeviceCreate の以前の呼び出しから取得したクライアント ドライバーのフレームワーク デバイス オブジェクトへのハンドル。

SessionId

MbbAdapterGetSessionId の以前の呼び出しから取得したデバイス サービス セッションの ID。

Data

デバイスに渡すデータを含む WDFMEMORY オブジェクト。

戻り値

なし

解説

MBBCx は、アプリケーションが DSS データをモデム デバイスに送信するときに、クライアント ドライバーの EvtMbbDeviceSendServiceSessionData コールバック関数を呼び出します。 データをデバイスに非同期的に送信した後、クライアント ドライバーは MbbDeviceSendServiceSessionDataComplete を呼び出して、MBBCx がデータに割り当てられたメモリを解放できるようにする必要があります。

例

次の例は、クライアントが DSS データをモデム デバイスに送信する方法を示しています。 簡潔でわかりやすくするために、この例ではエラー処理が取り残されています。

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);
}

要件

要件	値
サポートされている最小のクライアント	Windows 10 Version 1809
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.27
Header	mbbcx.h
IRQL	PASSIVE_LEVEL