MCD_INIT_DATA structure (mcd.h)
Le pilote de miniclasse de changeur remplit la structure MCD_INIT_DATA avec des pointeurs vers ses routines de traitement des commandes internes et les transmet au pilote de classe de changeur.
Syntaxe
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;
Membres
InitDataSize
Taille de cette structure en octets.
ChangerAdditionalExtensionSize
Pointeur vers la routine du pilote de miniclasse de changement qui retourne le nombre d’octets dont le pilote de miniclasse de changeur a besoin pour stocker des informations spécifiques au périphérique dans l’extension de périphérique. Cette routine a le prototype suivant :
typedef
ULONG
(*CHANGER_EXTENSION_SIZE)(
IN VOID
);
ChangerInitialize
Pointeur vers la routine de pilote de miniclasse changer qui effectue l’initialisation spécifique au pilote de miniclasse et lit le changeur pour recevoir d’autres requêtes. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_INITIALIZE)(
IN PDEVICE_OBJECT DeviceObject
);
ChangerError
Pointeur vers la routine de pilote de miniclasse de changeur qui effectue le traitement des erreurs spécifiques au périphérique. Cette routine a le prototype suivant :
typedef
VOID
(*CHANGER_ERROR_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PSCSI_REQUEST_BLOCK Srb,
IN NTSTATUS *Status,
IN BOOLEAN *Retry
);
ChangerPerformDiagnostics
Pointeur vers la routine de pilote de miniclasse de changeur qui effectue des tests de diagnostic sur l’appareil. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_PERFORM_DIAGNOSTICS)(
IN PDEVICE_OBJECT DeviceObject,
OUT PWMI_CHANGER_PROBLEM_DEVICE_ERROR changerDeviceError
);
ChangerGetParameters
Pointeur vers la routine de pilote de miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL IOCTL_CHANGER_GET_PARAMETERS. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
ChangerGetStatus
Pointeur vers la routine de pilote de miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL IOCTL_CHANGER_GET_STATUS. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
ChangerGetProductData
Pointeur vers une routine de pilote de miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL IOCTL_CHANGER_GET_PRODUCT_DATA. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
ChangerSetAccess
Pointeur vers une routine de pilote de miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL IOCTL_CHANGER_SET_ACCESS. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
ChangerGetElementStatus
Pointeur vers une routine de pilote de miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL IOCTL_CHANGER_GET_ELEMENT_STATUS. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
ChangerInitializeElementStatus
Pointeur vers une routine de pilote de miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL IOCTL_CHANGER_INITIALIZE_ELEMENT_STATUS. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
ChangerSetPosition
Pointeur vers une routine de pilote miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL IOCTL_CHANGER_SET_POSITION. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
ChangerExchangeMedium
Pointeur vers une routine de pilote de miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL IOCTL_CHANGER_EXCHANGE_MEDIUM. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
ChangerMoveMedium
Pointeur vers une routine de pilote de miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL IOCTL_CHANGER_MOVE_MEDIUM. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
ChangerReinitializeUnit
Pointeur vers une routine de pilote miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL IOCTL_CHANGER_REINITIALIZE_TRANSPORT. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
ChangerQueryVolumeTags
Pointeur vers une routine de pilote de miniclasse de changeur qui gère les aspects spécifiques d’un IRP de contrôle de périphérique avec le code IOCTL de IOCTL_CHANGER_QUERY_VOLUME_TAGS. Cette routine a le prototype suivant :
typedef
NTSTATUS
(*CHANGER_COMMAND_ROUTINE)(
IN PDEVICE_OBJECT DeviceObject,
IN PIRP Irp
);
Remarques
Cette structure est utilisée par le pilote de changeur dans Windows XP et les systèmes d’exploitation ultérieurs uniquement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | mcd.h (inclure Mcd.h) |
Voir aussi
ChangerAdditionalExtensionSize
ChangerInitializeElementStatus
IOCTL_CHANGER_GET_ELEMENT_STATUS
IOCTL_CHANGER_GET_PRODUCT_DATA