ChangerInitializeElementStatus 函式（mcd.h）

ChangerInitializeElementStatus 使用 IOCTL 程式代碼處理裝置控制 IRP 的裝置特定層面 IOCTL_CHANGER_INITIALIZE_ELEMENT_STATUS。

語法

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 以外的元素類型，則會傳回STATUS_INVALID_PARAMETER。

這是必要例程。

ChangerInitializeElementStatus 更新變更器的內部記憶體及其元素的目前資訊。

changer 類別驅動程式會先檢查 I/O 堆棧位置中的輸入緩衝區長度，再呼叫 changerInitializeElementStatus。

Irp->SystemBuffer 指向 CHANGER_INITIALIZE_ELEMENT_STATUS 結構做為輸入參數，指出要初始化狀態的專案，以及是否使用從條碼卷標取得的數據初始化項目狀態。

針對 SCSI 變更器，ChangerInitializeElementStatus 建置具有 CDB 的 SRB 來初始化項目狀態、將以零起始的元素地址轉譯為裝置特定位址，並將 SRB 傳送至系統埠驅動程式。

ChangerInitializeElementStatus 將 I/O 狀態區塊中的 [資訊] 字段設定為 sizeof（CHANGER_INITIALIZE_ELEMENT_STATUS），再返回變更器類別驅動程式。