SerCxRetrieveTransmitMdl 関数 (sercx.h)

  • [アーティクル]

SerCxRetrieveTransmitMdl メソッドは、送信する出力データの次のブロックを含むバッファーを記述する MDL を取得します。

構文

NTSTATUS SerCxRetrieveTransmitMdl(
  [in]  WDFDEVICE Device,
  [out] PMDL      *Mdl
);

パラメーター

[in] Device

シリアル コントローラーを表すフレームワーク デバイス オブジェクトへの WDFDEVICE ハンドル。

[out] Mdl

メソッドが MDL へのポインターを書き込む場所へのポインター。

戻り値

SerCxRetrieveTransmitMdl は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 可能な戻り値には、次のエラー コードが含まれます。

リターン コード 説明
STATUS_INVALID_DEVICE_REQUEST
 この値は、次のいずれかが発生した場合に返されます。
  • MDL を取得するための未処理の送信要求はありません。
  • ( SerCxProgressTransmit メソッドによって報告される) 現在の送信バイト数は 0 と等しくありません。
  • バッファーは既に取得されています ( SerCxProgressTransmit メソッドの対応する呼び出しはまだ発生していません)。
  • MDL は既に取得されています ( SerCxProgressTransmit メソッドの対応する呼び出しはまだ発生していません)。

注釈

シリアル コントローラー ドライバーは、この関数を呼び出して、現在の送信 (書き込み) 操作に使用する MDL を取得します。 MDL は、ドライバーが送信するデータを取得するバッファー メモリを記述します。 ドライバーは、 SerCxProgressTransmit メソッドを呼び出すまで、この MDL の排他的所有者です。その後、MDL ポインターが無効になり、MDL が記述する MDL またはバッファー メモリへのアクセスを試みる必要がなくなります。

MDL の詳細については、「MDL の使用」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 8以降で使用できます。
対象プラットフォーム ユニバーサル
Header sercx.h
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

SerCxProgressTransmit