WdfDeviceAllocAndQueryPropertyEx-Funktion (wdfdevice.h)

  • Artikel

[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 für ein 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 typisiertes Enumerator, der den Typ des zu zuweisenden 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 ordnet. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

[out] PropertyMemory

Ein Zeiger auf einen WDFMEMORY-typisierten Speicherort, der ein Handle für ein Frameworkspeicherobjekt empfängt.

[out] Type

Ein Zeiger auf eine DEVPROPTYPE-Variable . Wenn die Methode erfolgreich ist, enthält dieser Parameter nach der Rückgabe den Eigenschaftstypwert der in PropertyMemory gespeicherten Eigenschaftendaten.

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-Werte zurück.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

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

Die WdfDeviceAllocAndQueryPropertyEx-Methode bestimmt die Menge an Arbeitsspeicher, die erforderlich ist, um die angeforderte Geräteschnittstelleneigenschaft zu speichern. Sie weist genügend Arbeitsspeicher zu, um die Daten zu speichern, und gibt ein Handle an ein Frameworkspeicherobjekt zurück, das den zugeordneten Arbeitsspeicher beschreibt. Um auf die Daten zuzugreifen, kann Ihr Treiber WdfMemoryGetBuffer aufrufen.

Informationen zu verwandten Methoden finden Sie unter Zugreifen auf das Unified Device-Eigenschaftsmodell.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.13
UMDF-Mindestversion 2.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL APC_LEVEL

Weitere Informationen

WdfDeviceAllocAndQueryInterfaceProperty

WdfDeviceAllocAndQueryProperty