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 WdfCommonBufferCreate abgerufen hat.
Rückgabewert
WdfCommonBufferGetAlignedVirtualAddress gibt die virtuelle Adresse des Puffers zurück, die dem allgemeinen Puffer zugeordnet ist, den der CommonBuffer-Parameter angibt.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Wenn der Treiber WdfDeviceSetAlignmentRequirement heißt, um eine Pufferausrichtungsanforderung festzulegen, richtet das Framework den allgemeinen Puffer entsprechend dieser Ausrichtungsanforderung aus.
Weitere Informationen zu allgemeinen Puffern finden Sie unter Verwenden allgemeiner Puffer.
Beispiele
Ein Codebeispiel, das WdfCommonBufferGetAlignedVirtualAddress verwendet, finden Sie unter WdfCommonBufferCreate.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfcommonbuffer.h (einschließen von WdfCommonBuffer.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |