SerCx2 オブジェクトハンドル

[アーティクル]
04/04/2024

このトピックでは、シリアルフレームワーク拡張機能 (SerCx2) のバージョン 2 に対して特に定義されているオブジェクトハンドル型について説明します。

SerCx2 デバイスドライバーインターフェイス (DDI) は、これらのハンドルの種類を使用して、SerCx2 に固有の機能を持つオブジェクトを参照します。

さらに、SerCx2 DDI は、カーネルモードドライバーフレームワーク (KMDF) によって定義されている WDFDEVICE と WDFREQUEST の 2 つの汎用オブジェクトハンドル型を使用します。

フレームワークハンドル型の詳細については、「フレームワークオブジェクトの概要」をご参照ください。

このトピックでは、次のオブジェクトハンドルについて説明します。

SERCX2CUSTOMRECEIVE オブジェクトハンドル
SERCX2CUSTOMRECEIVETRANSACTION オブジェクトハンドル
SERCX2CUSTOMTRANSMIT オブジェクトハンドル
SERCX2CUSTOMTRANSMITTRANSACTION オブジェクトハンドル
SERCX2PIORECEIVE オブジェクトハンドル
SERCX2PIOTRANSMIT オブジェクトハンドル
SERCX2SYSTEMDMARECEIVE オブジェクトハンドル
SERCX2SYSTEMDMATRANSMIT オブジェクトハンドル

ヘッダー：2.0\Sercx.h

SERCX2CUSTOMRECEIVE オブジェクトハンドル

SERCX2CUSTOMRECEIVE オブジェクトハンドルは、シリアルフレームワーク拡張機能 (SerCx2) のバージョン 2 のカスタム受信オブジェクトへの不透明な参照です。

SerCx2CustomReceiveCreate メソッドは、カスタム受信オブジェクトを作成します。 SerCx2 はこのオブジェクトを使用して、シリアルコントローラーからデータを読み取るカスタムデータ転送メカニズムを使用する I/O トランザクションを管理します。このオブジェクトはシリアルコントローラードライバーに対して不透明です。

SerCx2CustomReceiveCreate は、出力パラメーターとして、新しく作成されたカスタム受信オブジェクトへの RCX2CUSTOMRECEIVE ハンドルを提供します。

SerCx2 およびシリアルコントローラードライバーは、このハンドルを使用して、SerCx2 メソッドとイベントコールバック関数への後続の呼び出しでオブジェクトを参照します。

SerCx2CustomReceiveCreate によってカスタム受信オブジェクトが作成された後、シリアルコントローラーデバイスを表すフレームワークデバイスオブジェクトの有効期間中、このオブジェクトが存在します。カスタム受信オブジェクトは、デバイスオブジェクトが削除されると自動的に削除されます。シリアルコントローラードライバーは、WdfObjectDelete などのメソッドを呼び出すことによって、カスタム受信オブジェクトを削除しないでください。

シリアルコントローラードライバーは、オプションとして、カスタム受信オブジェクトを作成できますが、このようなオブジェクトを 1 つ以上作成することはできません。

ドライバーは、次の条件下でのみこのオブジェクトを作成できます。

ドライバーは、以前に PIO 受信オブジェクトを作成しました。
ドライバーは、システム DMA 受信オブジェクトを作成していません 。

PIO 受信オブジェクトの詳細については、「RCX2PIORECEIVE オブジェクトハンドル」をご参照ください。

システム DMA 受信オブジェクトの詳細については、「RCX2PIORECEIVE オブジェクトハンドル」をご参照ください。

SERCX2CUSTOMRECEIVETRANSACTION オブジェクトハンドル

SERCX2CUSTOMRECEIVETRANSACTION オブジェクトハンドルは、シリアルフレームワーク拡張機能 (SerCx2) のバージョン 2 のカスタム受信トランザクションオブジェクトへの不透明な参照です。

SerCx2CustomReceiveTransactionCreate メソッドは、カスタムの受信トランザクションオブジェクトを作成します。 SerCx2 はこのオブジェクトを使用して、シリアルコントローラーによって受信されたデータを読み取るカスタムデータ転送メカニズムを使用する I/O トランザクションを管理します。

このオブジェクトはシリアルコントローラードライバーに対して不透明です。

SerCx2CustomReceiveTransactionCreate は、出力パラメーターとして、新しく作成されたカスタム受信トランザクションオブジェクトへの RCX2CUSTOMRECEIVETRANSACTION ハンドルを提供します。

SerCx2 とシリアルコントローラードライバーは、このハンドルを使用して、後続のカスタム受信トランザクションでオブジェクトを参照します。

詳細については、「SerCx2 カスタム受信トランザクション」をご参照ください。

SerCx2CustomReceiveTransactionCreate によってカスタム受信トランザクションオブジェクトが作成された後、シリアルコントローラーデバイスを表すフレームワークデバイスオブジェクトの有効期間中、このオブジェクトが存在します。

カスタム受信トランザクションオブジェクトは、デバイスオブジェクトが削除されると自動的に削除されます。

シリアルコントローラードライバーは、WdfObjectDelete などのメソッドを呼び出すことによって、カスタム受信トランザクションオブジェクトを削除しないでください。

シリアルコントローラードライバーは、オプションとして、カスタム受信トランザクションオブジェクトを作成できますが、このようなオブジェクトを 1 つ以上作成することはできません。

ドライバーは、次の条件下でのみこのオブジェクトを作成できます。</wdcml:p>

ドライバーは、以前に PIO 受信オブジェクトを作成しました。
ドライバーは、以前にカスタム受信オブジェクトを作成しました。

PIO 受信オブジェクトの詳細については、「RCX2PIORECEIVE オブジェクトハンドル」をご参照ください。カスタム受信オブジェクトの詳細については、SERCX2CUSTOMRECEIVE オブジェクトハンドル」をご参照ください。

カスタム受信オブジェクトとカスタム受信トランザクションオブジェクトの有効期間は似ていますが、SerCx2 デバイスドライバーインターフェイスの将来の拡張をサポートするために、これらは個別のオブジェクトの種類 (および 1 つの型に結合されない) として定義されます。

SERCX2CUSTOMTRANSMIT オブジェクトハンドル

SERCX2CUSTOMTRANSMIT オブジェクトハンドルは、シリアルフレームワーク拡張機能 (SerCx2) のバージョン 2 のカスタム送信オブジェクトへの不透明な参照です。

SerCx2CustomTransmitCreate メソッドは、カスタム送信オブジェクトを作成します。h SerCx2 はこのオブジェクトを使用して、シリアルコントローラーにデータを書き込む I/O トランザクションを管理します。このオブジェクトはシリアルコントローラードライバーに対して不透明です。

SerCx2CustomTransmitCreate は、出力パラメーターとして、新しく作成されたカスタム送信オブジェクトへの RCX2CUSTOMTRANSMIT ハンドルを提供します。 SerCx2 およびシリアルコントローラードライバーは、このハンドルを使用して、SerCx2 メソッドとイベントコールバック関数への後続の呼び出しでオブジェクトを参照します。

SerCx2CustomTransmitCreate によってカスタム送信オブジェクトが作成された後、シリアルコントローラーデバイスを表すフレームワークデバイスオブジェクトの有効期間中、このオブジェクトが存在します。

カスタム送信オブジェクトは、デバイスオブジェクトが削除されると自動的に削除されます。シリアルコントローラードライバーは、WdfObjectDelete などのメソッドを呼び出すことによって、カスタム送信オブジェクトを削除しないでください。

シリアルコントローラードライバーは、オプションとして、カスタム送信オブジェクトを作成できますが、このようなオブジェクトを 1 つ以上作成することはできません。

ドライバーは、次の条件下でのみこのオブジェクトを作成できます。

ドライバーは、以前に PIO 送信オブジェクトを作成しました。
ドライバーは、システム DMA 送信オブジェクトを作成していません 。

PIO 送信オブジェクトの詳細については、「RCX2PIORECEIVE オブジェクトハンドル」をご参照ください。システム DMA 送信オブジェクトの詳細については、「RCX2PIORECEIVE オブジェクトハンドル」をご参照ください。

SERCX2CUSTOMTRANSMITTRANSACTION オブジェクトハンドル

SERCX2CUSTOMTRANSMITTRANSACTION オブジェクトハンドルは、シリアルフレームワーク拡張機能 (SerCx2) のバージョン 2 のカスタム送信トランザクションオブジェクトへの不透明な参照です。

SerCx2CustomTransmitTransactionCreate メソッドは、カスタム送信トランザクションオブジェクトを作成します。 SerCx2 はこのオブジェクトを使用して、シリアルコントローラーにデータを書き込むカスタムデータ転送メカニズムを使用する I/O トランザクションを管理します。このオブジェクトはシリアルコントローラードライバーに対して不透明です。

SerCx2CustomTransmitTransactionCreate は、出力パラメーターとして、新しく作成されたカスタム送信トランザクションオブジェクトへの RCX2CUSTOMTRANSMITTRANSACTION ハンドルを提供します。 SerCx2 とシリアルコントローラードライバーは、このハンドルを使用して、後続のカスタム送信トランザクションでオブジェクトを参照します。

詳細については、「SerCx2 カスタム送信トランザクション」をご参照ください。

SerCx2CustomTransmitTransactionCreate によってカスタム送信トランザクションオブジェクトが作成された後、シリアルコントローラーデバイスを表すフレームワークデバイスオブジェクトの有効期間中、このオブジェクトが存在します。カスタム送信トランザクションオブジェクトは、デバイスオブジェクトが削除されると自動的に削除されます。シリアルコントローラードライバーは、WdfObjectDelete などのメソッドを呼び出すことによって、カスタム送信トランザクションオブジェクトを削除しないでください。

シリアルコントローラードライバーは、オプションとして、カスタム送信オブジェクトを作成できますが、このようなオブジェクトを 1 つ以上作成することはできません。ドライバーは、次の条件下でのみこのオブジェクトを作成できます。

ドライバーは、以前に PIO 送信オブジェクトを作成しました。
ドライバーは、システム DMA 送信オブジェクトを作成していません 。

PIO 送信オブジェクトの詳細については、「RCX2PIORECEIVE オブジェクトハンドル」をご参照ください。カスタム送信オブジェクトの詳細については、「SERCX2CUSTOMTRANSMIT オブジェクトハンドル」をご参照ください。

カスタム送信オブジェクトとカスタム送信トランザクションオブジェクトの有効期間は似ていますが、SerCx2 デバイスドライバーインターフェイスの将来の拡張をサポートするために、これらは個別のオブジェクトの種類 (および 1 つの型に結合されない) として定義されます。

SERCX2PIORECEIVE オブジェクトハンドル

SERCX2PIORECEIVE オブジェクトハンドルは、シリアルフレームワーク拡張機能 (SerCx2) のバージョン 2 のPIO 受信オブジェクトへの不透明な参照です。

SerCx2PioReceiveCreate メソッドは、PIO 受信オブジェクトを作成します。 SerCx2 は、シリアルコントローラーからデータを読み取るプログラムされた I/O (PIO) トランザクションを管理するためにオブジェクトを使用します。このオブジェクトはシリアルコントローラードライバーに対して不透明です。は、出力パラメーターとして、新しく作成された PIO 受信オブジェクトへの RCX2PIORECEIVE ハンドルを提供します。 SerCx2 とシリアルコントローラードライバーは、このハンドルを使用して、後続のPIO 受信トランザクションでオブジェクトを参照します。

詳細については、「SerCx2 PIO 受信トランザクション」をご参照ください。 SerCx2PioReceiveCreate によってPIO 受信オブジェクトが作成された後、シリアルコントローラーデバイスを表すフレームワークデバイスオブジェクトの有効期間中、このオブジェクトが存在しま PIO 受信オブジェクトは、デバイスオブジェクトが削除されると自動的に削除されます。シリアルコントローラードライバーは、WdfObjectDelete などのメソッドを呼び出すことによって、PIO 受信オブジェクトを削除しないでください。

シリアルコントローラードライバーは、PIO 受信オブジェクトを 1 つだけ作成する必要があります。ドライバーは、システム DMA 受信オブジェクトまたはカスタム受信オブジェクトを作成する前に、このオブジェクトを作成する必要があります。システム DMA 受信オブジェクトの詳細については、「RCX2PIORECEIVE オブジェクトハンドル」をご参照ください。カスタム受信オブジェクトの詳細については、SERCX2CUSTOMRECEIVE オブジェクトハンドル」をご参照ください。

SERCX2PIOTRANSMIT オブジェクトハンドル

SERCX2PIOTRANSMIT オブジェクトハンドルは、シリアルフレームワーク拡張機能 (SerCx2) のバージョン 2 のPIO 送信オブジェクトへの不透明な参照です。

SerCx2PioTransmitCreate メソッドは、PIO 送信オブジェクトを作成します。 SerCx2 では、このオブジェクトを使用して、シリアルコントローラーにデータを書き込むプログラムされた I/O (PIO) を使用する I/O トランザクションを管理します。このオブジェクトはシリアルコントローラードライバーに対して不透明です。 SerCx2PioTransmitCreate は、出力パラメーターとして、新しく作成された PIO 送信オブジェクトへの RCX2PIOTRANSMIT ハンドルを提供します。 SerCx2 とシリアルコントローラードライバーは、このハンドルを使用して、後続のPIO 送信トランザクションでオブジェクトを参照します。詳細については、「SerCx2 PIO 送信トランザクション」をご参照ください。SerCx2PioTransmitCreate によって PIO 送信オブジェクトが作成された後、シリアルコントローラーデバイスを表すフレームワークデバイスオブジェクトの有効期間中、このオブジェクトが存在します。 PIO 送信オブジェクトは、デバイスオブジェクトが削除されると自動的に削除されます。シリアルコントローラードライバーは、WdfObjectDelete などのメソッドを呼び出すことによって、PIO 送信オブジェクトを削除しないでください。

シリアルコントローラードライバーは、PIO 送信オブジェクトを 1 つだけ作成する必要があります。ドライバーは、システム DMA 送信オブジェクトまたはカスタム送信オブジェクトを作成する前に、このオブジェクトを作成する必要があります。システム DMA 送信オブジェクトの詳細については、「RCX2PIORECEIVE オブジェクトハンドル」をご参照ください。カスタム送信オブジェクトの詳細については、「SERCX2CUSTOMTRANSMIT オブジェクトハンドル」をご参照ください。

SERCX2SYSTEMDMARECEIVE オブジェクトハンドル

SERCX2SYSTEMDMARECEIVE オブジェクトハンドルは、シリアルフレームワーク拡張機能 (SerCx2) のバージョン 2 のシステム DMA 受信オブジェクトへの不透明な参照です。

SerCx2SystemDmaReceiveCreate メソッドは、システム DMA 受信オブジェクトを作成します。 SerCx2 は、シリアルコントローラーからデータを読み取るシステム DMA トランザクションを管理するためにこのオブジェクトを使用します。このオブジェクトはシリアルコントローラードライバーに対して不透明です。 SerCx2SystemDmaReceiveCreate は、出力パラメーターとして、新しく作成されたシステム DMA 受信オブジェクトへの RCX2SYSTEMDMARECEIVE ハンドルを提供します。 SerCx2 とシリアルコントローラードライバーは、このハンドルを使用して、後続のシステム DMA 受信トランザクションでオブジェクトを参照します。詳細については、「SerCx2 システム DMA 受信トランザクション」をご参照ください。

SerCx2SystemDmaReceiveCreate によってシステム DMA 受信オブジェクトが作成された後、シリアルコントローラーデバイスを表すフレームワークデバイスオブジェクトの有効期間中、このオブジェクトが存在します。システム DMA 受信オブジェクトは、デバイスオブジェクトが削除されると自動的に削除されます。シリアルコントローラードライバーは、オプションとして、システム DMA 受信オブジェクトを作成できますが、このようなオブジェクトを 1 つ以上作成することはできません。ドライバーは、次の条件下でのみこのオブジェクトを作成できます。

ドライバーは、以前に PIO 受信オブジェクトを作成しました。
ドライバーは、カスタム受信オブジェクトを作成していません 。

SERCX2SYSTEMDMATRANSMIT オブジェクトハンドル

SERCX2SYSTEMDMATRANSMIT オブジェクトハンドルは、シリアルフレームワーク拡張機能 (SerCx2) のバージョン 2 のシステム DMA 送信オブジェクトへの不透明な参照です。

SerCx2SystemDmaTransmitCreate メソッドは、システム DMA 送信オブジェクトを作成します。 SerCx2 は、シリアルコントローラーにデータを書き込むシステム DMA トランザクションを管理するためにこのオブジェクトを使用します。このオブジェクトはシリアルコントローラードライバーに対して不透明です。 SerCx2SystemDmaTransmitCreate は、出力パラメーターとして、新しく作成されたシステム DMA 送信オブジェクトへの RCX2SYSTEMDMATRANSMIT ハンドルを提供します。 SerCx2 とシリアルコントローラードライバーは、このハンドルを使用して、後続のシステム DMA 送信トランザクションでオブジェクトを参照します。詳細については、「SerCx2 システム DMA 送信トランザクション」をご参照ください。

SerCx2SystemDmaTransmitCreate によってシステム DMA 送信オブジェクトが作成された後、シリアルコントローラーデバイスを表すフレームワークデバイスオブジェクトの有効期間中、このオブジェクトが存在します。システム DMA 送信オブジェクトは、デバイスオブジェクトが削除されると自動的に削除されます。シリアルコントローラードライバーは、WdfObjectDelete などのメソッドを呼び出すことによって、システム DMA 送信オブジェクトを削除しないでください。

シリアルコントローラードライバーは、オプションとして、システム DMA 送信オブジェクトを作成できますが、このようなオブジェクトを 1 つ以上作成することはできません。ドライバーは、次の条件下でのみこのオブジェクトを作成できます。</wdcml:p>