/*
 * mcd.h
 *
 * Media changer driver interface
 *
 * This file is part of the w32api package.
 *
 * Contributors:
 *   Created by Casper S. Hornstrup <chorns@users.sourceforge.net>
 *
 * THIS SOFTWARE IS NOT COPYRIGHTED
 *
 * This source code is offered for use in the public domain. You may
 * use, modify or distribute it freely.
 *
 * This code is distributed in the hope that it will be useful but
 * WITHOUT ANY WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY
 * DISCLAIMED. This includes but is not limited to warranties of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 *
 */

#ifndef __MCD_H
#define __MCD_H

#if __GNUC__ >=3
#pragma GCC system_header
#endif

#ifdef __cplusplus
extern "C" {
#endif

#include "ntddk.h"
#include "srb.h"
#include "scsi.h"
#include "ntddchgr.h"

#if defined(_MCD_)
  #define CHANGERAPI DECLSPEC_EXPORT
#else
  #define CHANGERAPI DECLSPEC_IMPORT
#endif

#ifdef DebugPrint
#undef DebugPrint
#endif

#ifdef DBG
#define DebugPrint(x) ChangerClassDebugPrint x
#else
#define DebugPrint(x)
#endif

#define MAXIMUM_CHANGER_INQUIRY_DATA			252

CHANGERAPI
PVOID
DDKAPI
ChangerClassAllocatePool(
  /*IN*/ POOL_TYPE  PoolType,
  /*IN*/ ULONG  NumberOfBytes);

VOID
ChangerClassDebugPrint(
  ULONG  DebugPrintLevel,
  PCCHAR  DebugMessage,
  ...);

CHANGERAPI
PVOID
DDKAPI
ChangerClassFreePool(
  /*IN*/ PVOID  PoolToFree);

CHANGERAPI
NTSTATUS
DDKAPI
ChangerClassSendSrbSynchronous(
  /*IN*/ PDEVICE_OBJECT  DeviceObject,
  /*IN*/ PSCSI_REQUEST_BLOCK  Srb,
  /*IN*/ PVOID  Buffer,
  /*IN*/ ULONG  BufferSize,
  /*IN*/ BOOLEAN  WriteToDevice);


typedef NTSTATUS DDKAPI
(*CHANGER_INITIALIZE)(
  /*IN*/ PDEVICE_OBJECT  DeviceObject);

typedef ULONG DDKAPI
(*CHANGER_EXTENSION_SIZE)(
  VOID);

typedef VOID DDKAPI
(*CHANGER_ERROR_ROUTINE)(
  PDEVICE_OBJECT  DeviceObject,
  PSCSI_REQUEST_BLOCK  Srb,
  NTSTATUS  *Status,
  BOOLEAN  *Retry);

typedef NTSTATUS DDKAPI
(*CHANGER_COMMAND_ROUTINE)(
  /*IN*/ PDEVICE_OBJECT  DeviceObject,
  /*IN*/ PIRP  Irp);

typedef NTSTATUS DDKAPI
(*CHANGER_PERFORM_DIAGNOSTICS)(
  /*IN*/ PDEVICE_OBJECT  DeviceObject,
  /*OUT*/ PWMI_CHANGER_PROBLEM_DEVICE_ERROR  ChangerDeviceError);

typedef struct _MCD_INIT_DATA {
  ULONG  InitDataSize;
  CHANGER_EXTENSION_SIZE  ChangerAdditionalExtensionSize;
  CHANGER_INITIALIZE  ChangerInitialize;
  CHANGER_ERROR_ROUTINE  ChangerError;
  CHANGER_PERFORM_DIAGNOSTICS  ChangerPerformDiagnostics;
  CHANGER_COMMAND_ROUTINE  ChangerGetParameters;
  CHANGER_COMMAND_ROUTINE  ChangerGetStatus;
  CHANGER_COMMAND_ROUTINE  ChangerGetProductData;
  CHANGER_COMMAND_ROUTINE  ChangerSetAccess;
  CHANGER_COMMAND_ROUTINE  ChangerGetElementStatus;
  CHANGER_COMMAND_ROUTINE  ChangerInitializeElementStatus;
  CHANGER_COMMAND_ROUTINE  ChangerSetPosition;
  CHANGER_COMMAND_ROUTINE  ChangerExchangeMedium;
  CHANGER_COMMAND_ROUTINE  ChangerMoveMedium;
  CHANGER_COMMAND_ROUTINE  ChangerReinitializeUnit;
  CHANGER_COMMAND_ROUTINE  ChangerQueryVolumeTags;
} MCD_INIT_DATA, *PMCD_INIT_DATA;

CHANGERAPI
NTSTATUS
DDKAPI
ChangerClassInitialize(
  /*IN*/ PDRIVER_OBJECT  DriverObject,
  /*IN*/ PUNICODE_STRING  RegistryPath,
  /*IN*/ PMCD_INIT_DATA  MCDInitData);

#ifdef __cplusplus
}
#endif

#endif /* __MCD_H */
