ChangerMoveMedium 関数 (mcd.h)

[アーティクル]
02/29/2024

ChangerMoveMedium は、IOCTL コード IOCTL_CHANGER_MOVE_MEDIUMを使用して、デバイス制御 IRP のデバイス固有の側面を処理します。

構文

NTSTATUS ChangerMoveMedium(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

パラメーター

[in] DeviceObject

チェンジャーを表すデバイスオブジェクトへのポインター。

[in] Irp

IRP へのポインター。

戻り値

ChangerMoveMedium は、システムポートドライバーによって返される状態、または次のいずれかの値を返します。

STATUS_SUCCESS

STATUS_DESTINATION_ELEMENT_FULL

STATUS_INVALID_ELEMENT_ADDRESS

STATUS_INVALID_DEVICE_REQUEST

STATUS_INVALID_PARAMETER

STATUS_INSUFFICIENT_RESOURCES

STATUS_SOURCE_ELEMENT_EMPTY

注釈

このルーチンは必須です。

ChangerMoveMedium は、ある要素から別の要素にメディアの一部を移動します。

changer クラスドライバーは、 ChangerMoveMedium を呼び出す前に、I/O スタックの場所で入力バッファーの長さを確認します。 Irp-SystemBuffer> は、トランスポート要素、ソース、宛先、およびメディアを反転するかどうかを示すCHANGER_MOVE_MEDIUM構造体を指します。

ChangerMoveMedium は 、最初にトランスポート、ソース、および宛先の要素アドレスが有効であることを確認してから、0 から始まる要素アドレスをデバイス固有のアドレスに変換します。次に、CDB を使用して SRB をビルドしてメディアの一部を移動し、システムポートドライバーに送信します。

ChangerMoveMedium は、changer クラスドライバーに戻る前に、I/O 状態ブロックの Information フィールドを sizeof(CHANGER_MOVE_MEDIUM) に設定します。