IPort::GetDeviceProperty-Methode (portcls.h)

Die GetDeviceProperty-Methode bietet vereinfachten Zugriff auf Geräteeigenschaften, die in der Registrierung für Plug & Play Geräte enthalten sind.

Syntax

NTSTATUS GetDeviceProperty(
  DEVICE_REGISTRY_PROPERTY DeviceProperty,
  ULONG                    BufferLength,
  PVOID                    PropertyBuffer,
  PULONG                   ResultLength
);

Parameter

DeviceProperty

Identifiziert die bestimmte Geräteeigenschaft, die der Aufrufer anfordert. Die gültigen Werte für diesen Parameter sind identisch mit denen, die für den DeviceProperty-Parameter des IoGetDeviceProperty-Aufrufs definiert sind.

BufferLength

Gibt die Länge des Puffers in Bytes an, der die angeforderten Informationen empfangen soll.

PropertyBuffer

Zeiger auf den Eigenschaftenpuffer. Dieser Parameter verweist auf einen vom Aufrufer zugewiesenen Puffer, in den die Methode die angeforderten Eigenschafteninformationen schreibt. Der Puffer muss groß genug sein, um die in BufferLength angegebene Anzahl von Bytes zu enthalten.

ResultLength

Ausgabezeiger auf die Länge der zurückgegebenen Daten. Dieser Parameter verweist auf eine vom Aufrufer zugewiesene ULONG-Variable, in die die Methode eine Anzahl schreibt, die die Anzahl der Bytes angibt, die tatsächlich in den PropertyBuffer-Puffer geschrieben wurden. Wenn der Puffer jedoch zu klein ist, um die Informationen zu enthalten, gibt die -Methode stattdessen die erforderliche Puffergröße aus.

Rückgabewert

Diese Methode gibt NTSTATUS zurück, das STATUS_SUCCESS enthält, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück. Wenn der vom Aufrufer bereitgestellte Eigenschaftenpuffer zu klein ist, gibt die Methode STATUS_BUFFER_TOO_SMALL zurück und gibt die erforderliche Größe in ReturnLength aus.

Hinweise

Diese Methode ruft die Geräteeigenschaften des Audioadapters ab. Sie ähnelt der Funktion PcGetDeviceProperty, mit der Ausnahme, dass die Geräteeigenschaften des Audioadapters automatisch abgerufen werden, anstatt dass ein Geräteobjekt explizit ein Zielgerät angeben muss.

Anforderungen

Weitere Informationen

Iport