ntddchgr.h 標頭

發行項
08/07/2023

儲存體會使用此標頭。如需詳細資訊，請參閱

Storage

ntddchgr.h 包含下列程式設計介面：

IOCTLs


IOCTL_CHANGER_EXCHANGE_MEDIUM 將媒體片段從來源元素移至一個目的地，並將第一個目的地中原本的媒體片段移至第二個目的地。來源和第二個目的地通常相同，基本上會交換這兩個媒體片段。
IOCTL_CHANGER_GET_ELEMENT_STATUS 傳回所有專案的狀態，或特定類型之指定專案數目的狀態。如需可能專案類型的描述，請參閱CHANGER_ELEMENT。
IOCTL_CHANGER_GET_PARAMETERS 傳回裝置的參數。
IOCTL_CHANGER_GET_PRODUCT_DATA 傳回裝置的產品資料。
IOCTL_CHANGER_GET_STATUS 傳回裝置的目前狀態。
IOCTL_CHANGER_INITIALIZE_ELEMENT_STATUS 初始化所有專案的狀態，或特定型別的指定專案數目。
IOCTL_CHANGER_MOVE_MEDIUM 將媒體片段從來源元素移至目的地。
IOCTL_CHANGER_QUERY_VOLUME_TAGS 傳回指定專案的磁片區標籤資訊。
IOCTL_CHANGER_REINITIALIZE_TRANSPORT 實際重新調整傳輸元素，通常是在變更器開啟電源或呼叫端應用程式起始復原作業之後。重新建構可能牽涉到將傳輸傳回至其「主」位置。
IOCTL_CHANGER_SET_ACCESS 設定裝置匯入/匯出埠的狀態， (IEport) 、門或鍵盤。
IOCTL_CHANGER_SET_POSITION 將變更器的機器人傳輸機制設定為指定的專案位址，通常是藉由事先定位傳輸來優化移動或交換媒體。

結構


CHANGER_ELEMENT CHANGER_ELEMENT 結構包含變更器專案的描述。
CHANGER_ELEMENT_LIST CHANGER_ELEMENT_LIST 結構表示單一類型的專案範圍。
CHANGER_ELEMENT_STATUS _CHANGER_ELEMENT_STATUS 結構包含變更器迷你類別驅動程式所報告之指定CHANGER_ELEMENT的狀態。
CHANGER_ELEMENT_STATUS_EX 如果變更器迷你類別驅動程式提供產品資訊，則_CHANGER_ELEMENT_STATUS_EX結構包含指定之CHANGER_ELEMENT的狀態。
CHANGER_EXCHANGE_MEDIUM CHANGER_EXCHANGE_MEDIUM 結構會與IOCTL_CHANGER_EXCHANGE_MEDIUM要求搭配使用，以交換兩個媒體片段的位置。
CHANGER_INITIALIZE_ELEMENT_STATUS CHANGER_INITIALIZE_ELEMENT_STATUS 結構會與IOCTL_CHANGER_INITIALIZE_ELEMENT_STATUS要求搭配使用，以初始化所有專案的狀態或特定類型之指定數目的專案。
CHANGER_MOVE_MEDIUM CHANGER_MOVE_MEDIUM 結構會與IOCTL_CHANGER_MOVE_MEDIUM要求搭配使用，以將媒體片段從來源元素移至目的地。
CHANGER_PRODUCT_DATA CHANGER_PRODUCT_DATA結構會與IOCTL_CHANGER_GET_PRODUCT_DATA要求搭配使用，以擷取裝置的產品資料。
CHANGER_READ_ELEMENT_STATUS CHANGER_READ_ELEMENT_STATUS 結構會與IOCTL_CHANGER_GET_ELEMENT_STATUS要求搭配使用，以擷取所有專案的狀態，或特定類型之指定專案數目的狀態。
CHANGER_SEND_VOLUME_TAG_INFORMATION 此結構會傳遞至 ChangerQueryVolumeTags 常式，並用來指定用於擷取變更程式專案的搜尋準則。
CHANGER_SET_ACCESS CHANGER_SET_ACCESS結構會與theIOCTL_CHANGER_SET_ACCESS要求搭配使用，以設定裝置匯入/匯出埠的狀態， (IEport) 、門或鍵盤。
CHANGER_SET_POSITION CHANGER_SET_POSITION 結構會與theIOCTL_CHANGER_SET_POSITION要求搭配使用，以將變更器的機器人傳輸機制設定為指定的專案位址。
GET_CHANGER_PARAMETERS 擷取變更器的特性。
READ_ELEMENT_ADDRESS_INFO 此結構是根據呼叫 ChangerQueryVolumeTags 常式中指定的搜尋準則來擷取變更器專案。

列舉


CHANGER_DEVICE_PROBLEM_TYPE CHANGER_DEVICE_PROBLEM_TYPE資料類型包含 ChangerPerformDiagnostics 常式所傳回的值。
ELEMENT_TYPE ELEMENT_TYPE列舉提供 SCSI-3 規格所定義的變更專案類型清單。