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

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

ChangerInitializeElementStatus は、その要素に関する現在の情報を使用して、チェンジャーの内部メモリを更新します。

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) に設定します。