SerCxRetrieveTransmitMdl 関数 (sercx.h)
SerCxRetrieveTransmitMdl メソッドは、送信する出力データの次のブロックを含むバッファーを記述する MDL を取得します。
構文
NTSTATUS SerCxRetrieveTransmitMdl(
[in] WDFDEVICE Device,
[out] PMDL *Mdl
);
パラメーター
[in] Device
シリアル コントローラーを表すフレームワーク デバイス オブジェクトへの WDFDEVICE ハンドル。
[out] Mdl
メソッドが MDL へのポインターを書き込む場所へのポインター。
戻り値
SerCxRetrieveTransmitMdl は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 可能な戻り値には、次のエラー コードが含まれます。
リターン コード | 説明 |
---|---|
|
この値は、次のいずれかが発生した場合に返されます。
|
注釈
シリアル コントローラー ドライバーは、この関数を呼び出して、現在の送信 (書き込み) 操作に使用する MDL を取得します。 MDL は、ドライバーが送信するデータを取得するバッファー メモリを記述します。 ドライバーは、 SerCxProgressTransmit メソッドを呼び出すまで、この MDL の排他的所有者です。その後、MDL ポインターが無効になり、MDL が記述する MDL またはバッファー メモリへのアクセスを試みる必要がなくなります。
MDL の詳細については、「MDL の使用」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8以降で使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | sercx.h |
IRQL | <= DISPATCH_LEVEL |