ChangerGetProductData, fonction (mcd.h)

ChangerGetProductData gère les aspects spécifiques d’un IRP de contrôle d’appareil avec le code IOCTL IOCTL_CHANGER_GET_PRODUCT_DATA.

Syntaxe

NTSTATUS ChangerGetProductData(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

Paramètres

[in] DeviceObject

Pointeur vers l’objet d’appareil qui représente le changeur.

[in] Irp

Pointeur vers l’IRP.

Valeur retournée

ChangerGetProductData retourne toujours STATUS_SUCCESS.

Remarques

Cette routine est obligatoire.

ChangerGetProductData retourne les données de produit d’un changeur.

Le pilote de classe de changeur vérifie la longueur de la mémoire tampon de sortie dans l’emplacement de la pile d’E/S avant d’appeler ChangerGetProductData. Si la longueur de la mémoire tampon de sortie est inférieure à sizeof(CHANGER_PRODUCT_DATA), le pilote de classe de change retourne avec une valeur de STATUS_INFO_LENGTH_MISMATCH

ChangerGetProductData remplit une structure CHANGER_PRODUCT_DATA dans Irp-AssociatedIrp.SystemBuffer> avant de revenir au pilote de classe de changeur. Si le pilote miniclasse a mis en cache les données d’interrogation dans l’extension d’appareil du changeur avant de retourner à partir de ChangerInitialize, tous les membres à l’exception de DeviceType peuvent être renseignés à partir de ces données.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	mcd.h (inclure Mcd.h, Ntddchgr.h)
IRQL	PASSIVE_LEVEL

Voir aussi

CHANGER_PRODUCT_DATA

ChangerInitialize