SerCx2SystemDmaTransmitCreate 関数 (sercx.h)

SerCx2SystemDmaTransmitCreate メソッドは、SerCx2 システム DMA 送信オブジェクトを作成します。このオブジェクトは、シリアル フレームワーク拡張機能 (SerCx2) のバージョン 2 がシステム DMA 送信トランザクションの実行に使用します。

構文

NTSTATUS SerCx2SystemDmaTransmitCreate(
  [in]           WDFDEVICE                          Device,
  [in]           PSERCX2_SYSTEM_DMA_TRANSMIT_CONFIG SystemDmaTransmitConfig,
  [in, optional] PWDF_OBJECT_ATTRIBUTES             Attributes,
  [out]          SERCX2SYSTEMDMATRANSMIT            *SystemDmaTransmit
);

パラメーター

[in] Device

シリアル コントローラーを表すフレームワーク デバイス オブジェクトへの WDFDEVICE ハンドル。 シリアル コントローラー ドライバーは、EvtDriverDeviceAdd コールバック関数でこのオブジェクトを作成しました。 詳細については、「SerCx2InitializeDevice」を参照してください。

[in] SystemDmaTransmitConfig

SERCX2_SYSTEM_DMA_TRANSMIT_CONFIG 構造体へのポインター。 このメソッドを呼び出す前に、呼び出し元は SERCX2_SYSTEM_DMA_TRANSMIT_CONFIG_INIT 関数を呼び出して構造体を初期化する必要があります。 この構造体には、シリアル コントローラー ドライバーによって実装されるイベント コールバック ルーチンのセットへのポインターが含まれています。 SerCx2 はこれらの関数を呼び出して、システム DMA 送信トランザクションを実行します。

[in, optional] Attributes

新しい system-DMA-transmit オブジェクトに割り当てる属性を記述する WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このメソッドを呼び出す前に、呼び出し元は WDF_OBJECT_ATTRIBUTES_INIT 関数を呼び出して構造体を初期化する必要があります。 このパラメーターは省略可能であり、シリアル コントローラー ドライバーがオブジェクトに属性を割り当てる必要がない場合は、WDF_NO_OBJECT_ATTRIBUTESとして指定できます。 詳細については、「解説」を参照してください。

[out] SystemDmaTransmit

このメソッドが新しく作成した system-DMA-transmit オブジェクトに SERCX2SYSTEMDMATRANSMIT ハンドルを書き込む場所へのポインター。 SerCx2 とシリアル コントローラー ドライバーは、このオブジェクトを参照する後続の呼び出しでこのハンドルを使用します。

戻り値

このメソッドは、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 考えられるエラー戻り値には、次の状態コードが含まれます。

備考

シリアル コントローラー ドライバーでは、このメソッドを使用して、システム DMA 送信オブジェクトを作成できます。 SerCx2 は、このオブジェクトを使用してシステム DMA 送信トランザクションを実行します。これは、システム DMA コントローラーを使用して、送信するシリアル コントローラーにデータを書き込むトランザクションです。

通常、シリアル コントローラー ドライバーは、EvtDevicePrepareHardware コールバック関数から SerCx2SystemDmaTransmitCreate 呼び出します。 この関数は、システム DMA チャネルを含めることができるハードウェア リソースの一覧を受け取ります。

シリアル コントローラー ドライバーは、SerCx2SystemDmaTransmitCreateを呼び出す前に、SerCx2InitializeDevice を正常に呼び出し、SerCx2PioTransmitCreate メソッド する必要があります。

SerCx2SystemDmaTransmitCreate呼び出す前に、シリアル コントローラー ドライバーは SERCX2_SYSTEM_DMA_TRANSMIT_CONFIG_INIT 関数を呼び出して、SystemDmaTransmitConfigが指す SERCX2_SYSTEM_DMA_TRANSMIT_CONFIG 構造体 初期化する必要があります。 この関数は、構造体の次のメンバーを 0 に設定します。

• MaximumScatterGatherFragments の
• MinimumTransferUnitOverride の
• DmaAlignment
• MinimumTransactionLength
• 排他