struttura WDF_COMMON_BUFFER_CONFIG (wdfcommonbuffer.h)
[Si applica solo a KMDF]
La struttura WDF_COMMON_BUFFER_CONFIG contiene informazioni di configurazione per un buffer comune.
Sintassi
typedef struct _WDF_COMMON_BUFFER_CONFIG {
ULONG Size;
ULONG AlignmentRequirement;
} WDF_COMMON_BUFFER_CONFIG, *PWDF_COMMON_BUFFER_CONFIG;
Membri
Size
Dimensione, in byte, di questa struttura.
AlignmentRequirement
Requisito di allineamento per un buffer comune. Questo valore deve essere minore del limite di allineamento. Ad esempio, è possibile specificare 15 per un limite di allineamento a 16 byte e 31 per un limite di allineamento a 32 byte. È anche possibile usare una delle costanti_ALIGNMENT xxxx FILE_definite in Wdm.h.
Osservazioni
La struttura WDF_COMMON_BUFFER_CONFIG viene utilizzata come input per il metodo WdfCommonBufferCreateWithConfig.
Se il driver specifica un requisito di allineamento maggiore della dimensione della pagina del computer (PAGE_SIZE), gli indirizzi logici restituiti dal metodo WdfCommonBufferGetAlignedLogicalAddress metodo vengono sempre allineati al requisito di allineamento specificato, ma gli indirizzi virtuali restituiti dal metodo WdfCommonBufferGetAlignedVirtualAddress metodo potrebbero non essere allineati al requisito di allineamento.
Se il driver specifica un requisito di allineamento inferiore alle dimensioni della pagina del computer, tutti gli indirizzi logici e virtuali sono allineati al requisito di allineamento specificato.
Per altre informazioni sulla specifica dei requisiti di allineamento, vedere Abilitazione delle transazioni DMA e uso di buffer comuni.
Fabbisogno
| Requisito | Valore |
|---|---|
| versione minima di KMDF | 1.0 |
| intestazione | wdfcommonbuffer.h (include WdfCommonBuffer.h) |
Vedere anche
WdfCommonBufferCreateWithConfig