WdfDeviceAllocAndQueryPropertyEx-Funktion (wdfdevice.h)
[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 |
|---|---|
|
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 |