SerCx2CustomTransmitTransactionCreate 関数 (sercx.h)
SerCx2CustomTransmitTransactionCreate メソッドは、カスタム送信トランザクション オブジェクトを作成します。このオブジェクトは、シリアル フレームワーク拡張機能 (SerCx2) のバージョン 2 がカスタム送信トランザクションの実行に使用します。
構文
NTSTATUS SerCx2CustomTransmitTransactionCreate(
[in] SERCX2CUSTOMTRANSMIT CustomTransmit,
[in] PSERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG CustomTransmitTransactionConfig,
[in] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] SERCX2CUSTOMTRANSMITTRANSACTION *CustomTransmitTransaction
);
パラメーター
[in] CustomTransmit
カスタム送信オブジェクトへの SERCX2CUSTOMTRANSMIT ハンドル。 シリアル コントローラー ドライバーは、以前にこのオブジェクトを作成するために、SerCx2CustomTransmitCreate メソッドを呼び出しました。
[in] CustomTransmitTransactionConfig
SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG 構造体へのポインター。 このメソッドを呼び出す前に、呼び出し元は SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG_INIT 関数を呼び出して構造体を初期化する必要があります。 この構造体には、シリアル コントローラー ドライバーによって実装されるイベント コールバック ルーチンのセットへのポインターが含まれています。 SerCx2 は、これらの関数を呼び出して、カスタム データ転送メカニズムを使用して送信されるシリアル コントローラーにデータを書き込む I/O トランザクションを実行します。
[in] Attributes
新しいカスタム送信トランザクション オブジェクトに割り当てる属性を記述する WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このメソッドを呼び出す前に、呼び出し元は WDF_OBJECT_ATTRIBUTES_INIT 関数を呼び出して構造体を初期化する必要があります。 このパラメーターは省略可能であり、シリアル コントローラー ドライバーがオブジェクトに属性を割り当てる必要がない場合は、WDF_NO_OBJECT_ATTRIBUTESとして指定できます。 詳細については、「解説」を参照してください。
[out] CustomTransmitTransaction
このメソッドが新しく作成したカスタム送信トランザクション オブジェクトに SERCX2CUSTOMTRANSMITTRANSACTION ハンドルを書き込む場所へのポインター。 SerCx2 とシリアル コントローラー ドライバーは、このオブジェクトを参照する後続の呼び出しでこのハンドルを使用します。
戻り値
このメソッドは、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 考えられるエラー戻り値には、次の状態コードが含まれます。
| リターン コード | 形容 |
|---|---|
|
カスタム送信トランザクション オブジェクトは、SerCx2CustomTransmitTransactionCreate 呼び出しの前の |
|
|
|
パラメーター値が無効です。 呼び出し元は、有効な EvtSerCx2CustomTransmitTransactionStart 関数ポインターを指定する必要があります。 |
|
カスタム送信トランザクション オブジェクトを作成するために使用できるリソースが不足しています。 |
備考
シリアル コントローラー ドライバーは、このメソッドを呼び出して、カスタム送信トランザクション オブジェクトを作成できます。 SerCx2 は、このオブジェクトを使用してカスタム送信トランザクションを管理します。これは、送信するシリアル コントローラーにデータを書き込むためのカスタム データ転送メカニズムを使用する I/O トランザクションです。
オプションとして、シリアル コントローラー ドライバーは、
属性 パラメーターが WDF_OBJECT_ATTRIBUTES 構造体を指している場合、呼び出し元は、WDF_OBJECT_ATTRIBUTES_INIT 初期化関数が ParentObject、ExecutionLevel、およびこの構造体の SynchronizationScope メンバーに書き込む値を上書きしてはなりません。
実装されたコールバック関数の指定された組み合わせが無効な場合、SerCx2CustomTransmitTransactionCreate
カスタム送信トランザクション オブジェクトの作成の詳細については、SERCX2CUSTOMTRANSMITTRANSACTIONを参照してください。 カスタム送信トランザクションの詳細については、「SerCx2 Custom-Transmit Transactions」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8.1以降で使用できます。 |
| ターゲット プラットフォーム の |
万国 |
| ヘッダー | sercx.h |
| IRQL | PASSIVE_LEVEL |
関連項目
EvtCleanupCallback を
EvtDestroyCallback の
EvtSerCx2CustomTransmitTransactionStart を
SERCX2CUSTOMTRANSMITTRANSACTION
SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG
SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG_INIT
SerCx2CustomTransmitCreate を