IOCTL_CHANGER_SET_POSITION - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// ntddchgr.h

// CTL_CODE(0x0030, 0x007, METHOD_BUFFERED, FILE_READ_ACCESS)
#define IOCTL_CHANGER_SET_POSITION 0x0030401C
View the official Windows Driver Kit DDI reference
// winioctl.h

// CTL_CODE(0x0030, 0x007, METHOD_BUFFERED, FILE_READ_ACCESS)
#define IOCTL_CHANGER_SET_POSITION 0x0030401C
View the official Win32 API reference

NtDoc

No description available.

Windows Driver Kit DDI reference (ni-ntddchgr-ioctl_changer_set_position)

IOCTL_CHANGER_SET_POSITION IOCTL

Description

Sets the changer's robotic transport mechanism to the specified element address, typically to optimize moving or exchanging media by positioning the transport beforehand.

Parameters

Major code

Input buffer

The buffer at Irp->AssociatedIrp.SystemBuffer contains a CHANGER_SET_POSITION structure that specifies the transport to move and the destination. If the Flip member is TRUE and the device supports two-sided media, the media currently carried by the transport should be flipped.

Input buffer length

Parameters.DeviceIoControl.InputBufferLength in the I/O stack location indicates the size, in bytes, of the parameter buffer, which must be >= sizeof(CHANGER_SET_POSITION).

Output buffer

None.

Output buffer length

None.

Input/output buffer

Input/output buffer length

Status block

The Information field is set to sizeof(CHANGER_SET_POSITION). The Status field is set to STATUS_SUCCESS, or possibly to STATUS_INFO_LENGTH_MISMATCH, STATUS_INSUFFICIENT_RESOURCES, STATUS_INVALID_DEVICE_REQUEST, or STATUS_INVALID_PARAMETER.

See also

CHANGER_SET_POSITION

ChangerSetPosition


Win32 API reference (ni-winioctl-ioctl_changer_set_position)

IOCTL_CHANGER_SET_POSITION IOCTL

Description

Sets the changer's robotic transport mechanism to the specified element address. This optimizes moving or exchanging media by positioning the transport beforehand.

To perform this operation, call the DeviceIoControl function with the following parameters.

BOOL DeviceIoControl(
  (HANDLE) hDevice,             // handle to device
  IOCTL_CHANGER_SET_POSITION,   // dwIoControlCode
  (LPVOID) lpInBuffer,          // input buffer
  (DWORD) nInBufferSize,        // size of input buffer
  NULL,                         // lpOutBuffer
  0,                            // nOutBufferSize
  (LPDWORD) lpBytesReturned,    // number of bytes returned
  (LPOVERLAPPED) lpOverlapped   // OVERLAPPED structure
);

Parameters

Input buffer

Input buffer length

Output buffer

Output buffer length

Input/output buffer

Input/output buffer length

Status block

Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful.

Otherwise, Status to the appropriate error condition as a NTSTATUS code.

For more information, see NTSTATUS Values.

See also