WdfDeviceAllocAndQueryPropertyEx-Funktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WdfDeviceAllocAndQueryPropertyEx--Methode weist einen Puffer zu und ruft eine angegebene Geräteeigenschaft ab.

Syntax

NTSTATUS WdfDeviceAllocAndQueryPropertyEx(
  [in]           WDFDEVICE                 Device,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           POOL_TYPE                 PoolType,
  [in, optional] PWDF_OBJECT_ATTRIBUTES    PropertyMemoryAttributes,
  [out]          WDFMEMORY                 *PropertyMemory,
  [out]          PDEVPROPTYPE              Type
);

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] DeviceProperty

Ein Zeiger auf eine WDF_DEVICE_PROPERTY_DATA Struktur, die die abzurufende Geräteeigenschaft identifiziert.

[in] PoolType

Ein POOL_TYPE-typed-Enumerator, der den Zuteilungstyp des zuzuordnenden Arbeitsspeichers angibt.

[in, optional] PropertyMemoryAttributes

Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES Struktur, die Objektattribute für das Speicherobjekt beschreibt, das die Funktion zuweist. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

[out] PropertyMemory

Ein Zeiger auf einen WDFMEMORY-typierten Speicherort, der ein Handle für ein Framework-Speicherobjekt empfängt.

[out] Type

Ein Zeiger auf eine DEVPROPTYPE- Variable. Wenn die Methode erfolgreich ist, enthält dieser Parameter den Eigenschaftstypwert der Eigenschaftendaten, die in PropertyMemorygespeichert sind.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt WdfDeviceAllocAndQueryPropertyEx- STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Der angegebene DeviceProperty Wert ist ungültig.

Die Methode gibt möglicherweise andere NTSTATUS-Wertezurück.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Sie können WdfDeviceAllocAndQueryPropertyEx- verwenden, um alle Eigenschaften abzurufen, die über das einheitliche Eigenschaftenmodell verfügbar gemacht werden, während die WdfDeviceAllocAndQueryProperty- methode nur das Abfragen einer Teilmenge des einheitlichen Eigenschaftenmodells zulässt.

Die WdfDeviceAllocAndQueryPropertyEx--Methode bestimmt die Speichermenge, die zum Speichern der angeforderten Geräteschnittstelleneigenschaft erforderlich ist. Es weist genügend Arbeitsspeicher zum Speichern der Daten zu und gibt ein Handle zu einem Framework-Speicherobjekt zurück, das den zugewiesenen Speicher beschreibt. Um auf die Daten zuzugreifen, kann Ihr Treiber WdfMemoryGetBuffer-aufrufen.

Informationen zu verwandten Methoden finden Sie unter Zugreifen auf das Unified Device Property Model.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.13
Mindest-UMDF-Version	2.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	APC_LEVEL

Siehe auch

WdfDeviceAllocAndQueryInterfaceProperty

WdfDeviceAllocAndQueryProperty

Freigeben über