WDF_COMMON_BUFFER_CONFIG struttura (wdfcommonbuffer.h)

  • Articolo

[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;

Members

Size

Dimensione, in byte, della 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 FILE_Xxxx_ALIGNMENT definite in Wdm.h.

Commenti

La struttura WDF_COMMON_BUFFER_CONFIG viene usata 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 sono sempre allineati al requisito di allineamento specificato, ma gli indirizzi virtuali restituiti dal metodo WdfCommonBufferGetAlignedVirtualAddress potrebbero non essere allineati al requisito di allineamento.

Se il driver specifica un requisito di allineamento minore delle 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.

Requisiti

Requisito Valore
Versione KMDF minima 1.0
Intestazione wdfcommonbuffer.h (include WdfCommonBuffer.h)

Vedi anche

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress