ChangerGetProductData-Funktion (mcd.h)

Artikel
02/26/2024

ChangerGetProductData behandelt die gerätespezifischen Aspekte einer Gerätesteuerungs-IRP mit dem IOCTL-Code IOCTL_CHANGER_GET_PRODUCT_DATA.

Syntax

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

Parameter

[in] DeviceObject

Zeiger auf das Geräteobjekt, das den Changer darstellt.

[in] Irp

Zeiger auf die IRP.

Rückgabewert

ChangerGetProductData gibt immer STATUS_SUCCESS zurück.

Hinweise

Diese Routine ist erforderlich.

ChangerGetProductData gibt Produktdaten für einen Changer zurück.

Der Changer-Klassentreiber überprüft die Länge des Ausgabepuffers am E/A-Stapelspeicherort, bevor ChangerGetProductData aufgerufen wird. Wenn die Länge des Ausgabepuffers kleiner als sizeof(CHANGER_PRODUCT_DATA) ist, gibt der Changer-Klassentreiber den Wert STATUS_INFO_LENGTH_MISMATCH

ChangerGetProductData füllt eine CHANGER_PRODUCT_DATA-Struktur unter Irp-AssociatedIrp.SystemBuffer > aus, bevor sie zum Changer-Klassentreiber zurückkehren. Wenn der Miniklassentreiber Abfragedaten in der Geräteerweiterung des Changers zwischengespeichert hat, bevor er von ChangerInitialize zurückkehrt, können alle Member mit Ausnahme von DeviceType aus diesen Daten ausgefüllt werden.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	mcd.h (include Mcd.h, Ntddchgr.h)
IRQL	PASSIVE_LEVEL

Weitere Informationen

CHANGER_PRODUCT_DATA

ChangerInitialize

Freigeben über