ChangerInitializeElementStatus 関数 (mcd.h)

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

構文

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

[in] DeviceObject

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

[in] Irp

IRP へのポインター。

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

STATUS_SUCCESS

STATUS_INVALID_PARAMETER

STATUS_INSUFFICIENT_RESOURCES

changer が特定の型の要素の範囲の初期化をサポートせず、ChangerInitializeElementStatus が AllElements 以外の要素型で呼び出された場合は、STATUS_INVALID_PARAMETERを返します。

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

ChangerInitializeElementStatus は、要素に関する現在の情報を使用して、changer の内部メモリを更新します。

changer クラスドライバーは、 ChangerInitializeElementStatus を呼び出す前に、I/O スタックの場所で入力バッファーの長さを確認します。

Irp-SystemBuffer> は、状態を初期化する要素と、バーコードラベルから取得したデータを使用して要素の状態を初期化するかどうかを示す入力パラメーターとして、CHANGER_INITIALIZE_ELEMENT_STATUS構造体を指します。

SCSI チェンジャーの場合、 ChangerInitializeElementStatus は CDB を使用して SRB をビルドして要素の状態を初期化し、0 から始まる要素アドレスをデバイス固有のアドレスに変換し、SRB をシステムポートドライバーに送信します。

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