Freigeben über


IOCTL_PAR_QUERY_DEVICE_ID IOCTL (ntddpar.h)

Die IOCTL_PAR_QUERY_DEVICE_ID Anforderung gibt die IEEE 1284-Geräte-ID eines parallelen Geräts zurück, das vom vom System bereitgestellten Funktionstreiber für parallele Ports zugewiesen wurde.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Nichts.

Eingabepufferlänge

Nichts.

Ausgabepuffer

Der AssociatedIrp.SystemBuffer Member verweist auf einen Puffer, den der Client der Ausgabe der Geräte-ID zuweist. Der Puffer enthält die Geräte-ID und einen NULL- Terminator.

Länge des Ausgabepuffers

Der Parameters.DeviceIoControl.OutputBufferLength Member gibt die Größe des Ausgabepuffers in Byte an, der sowohl die Geräte-ID als auch eine NULL- Endator enthalten kann. Ein Client kann eine IOCTL_PAR_QUERY_DEVICE_ID_SIZE Anforderung verwenden, um die erforderliche Puffergröße zu ermitteln. Eine Geräte-ID kann bis zu 64 KB groß sein.

Statusblock

Wenn die Anforderung erfolgreich ist, wird das Information Member auf die Größe eines Puffers festgelegt, der sowohl die Geräte-ID als auch einen NULL--Endator enthält. Andernfalls wird der Information Member auf Null festgelegt.

Der Status Members wird auf einen der generischen Statuswerte festgelegt, die von Gerätesteuerungsanforderungen für parallele Geräte oder auf einen der folgenden Werte zurückgegeben werden:

STATUS_BUFFER_TOO_SMALL

Der Ausgabepuffer, auf den AssociatedIrp.SystemBuffer verweist, ist kleiner als die Größe der Geräte-ID und ein NULL Endator.

STATUS_IO_DEVICE_ERROR

Ein Geräte-E/A-Fehler ist aufgetreten.

Anforderungen

Anforderung Wert
Header- ntddpar.h (include Ntddpar.h)

Siehe auch

IOCTL_PAR_QUERY_DEVICE_ID_SIZE