WdfCommonBufferGetAlignedVirtualAddress-Funktion (wdfcommonbuffer.h)
[Gilt nur für KMDF]
Die WdfCommonBufferGetAlignedVirtualAddress Methode gibt die virtuelle Adresse zurück, die einem angegebenen allgemeinen Puffer zugeordnet ist.
Syntax
PVOID WdfCommonBufferGetAlignedVirtualAddress(
[in] WDFCOMMONBUFFER CommonBuffer
);
Parameter
[in] CommonBuffer
Ein Handle für ein allgemeines Pufferobjekt, das der Treiber durch einen vorherigen Aufruf von WdfCommonBufferCreateabgerufen hat.
Rückgabewert
WdfCommonBufferGetAlignedVirtualAddress die virtuelle Adresse des Puffers zurück, der dem allgemeinen Puffer zugeordnet ist, den der CommonBuffer Parameter angibt.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Wenn der Treiber WdfDeviceSetAlignmentRequirement aufgerufen wird, um eine Pufferausrichtungsanforderung festzulegen, richtet das Framework den allgemeinen Puffer entsprechend dieser Ausrichtungsanforderung aus.
Weitere Informationen zu allgemeinen Puffern finden Sie unter Using Common Buffers
Beispiele
Ein Codebeispiel, das WdfCommonBufferGetAlignedVirtualAddressverwendet, finden Sie unter WdfCommonBufferCreate.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Header- | wdfcommonbuffer.h (include WdfCommonBuffer.h) |
| Library | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |