WDF_MEMORY_DESCRIPTOR_INIT_MDL-Funktion (wdfmemory.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WDF_MEMORY_DESCRIPTOR_INIT_MDL-Funktion initialisiert eine WDF_MEMORY_DESCRIPTOR-Struktur , sodass sie eine angegebene Speicherdeskriptorliste (MDL) beschreibt.

Syntax

void WDF_MEMORY_DESCRIPTOR_INIT_MDL(
  [out] PWDF_MEMORY_DESCRIPTOR Descriptor,
  [in]  PMDL                   Mdl,
  [in]  ULONG                  BufferLength
);

Parameter

[out] Descriptor

Ein Zeiger auf eine WDF_MEMORY_DESCRIPTOR Struktur.

[in] Mdl

Ein Zeiger auf eine MDL, die einen Puffer beschreibt.

[in] BufferLength

Die Größe des Puffers, den Mdl angibt, in Bytes.

Rückgabewert

Keine

Bemerkungen

Die WDF_MEMORY_DESCRIPTOR_INIT_MDL-Funktion nullt die angegebene WDF_MEMORY_DESCRIPTOR-Struktur und legt das Element Type der Struktur auf WdfMemoryDescriptorTypeMdl fest. Anschließend werden die Elemente u.MdlType.Mdl und u.MdlType.BufferLength der Struktur auf die Werte festgelegt, die vom Mdl - bzw. BufferLength-Parameter angegeben werden.

Beispiele

Im folgenden Codebeispiel wird ein Puffer zugewiesen, eine MDL für den Puffer erstellt und die MDL verwendet, um eine WDF_MEMORY_DESCRIPTOR Struktur zu initialisieren.

PVOID  pBuffer = NULL;
PMDL  pMdl = NULL;

pBuffer = ExAllocatePoolWithTag(
                                NonPagedPool, 
                                BUFFER_LENGTH, 
                                IOTARGET_DRIVER_TAG
                                );
if (pBuffer == NULL){
    Status = STATUS_UNSUCCESSFUL;
    goto Cleanup;
}
pMdl = IoAllocateMdl(
                     pBuffer,
                     BUFFER_LENGTH,
                     FALSE,
                     TRUE,
                     NULL
                     );
if (pMdl == NULL){
    Status = STATUS_UNSUCCESSFUL;
    goto Cleanup;
}
MmBuildMdlForNonPagedPool(pMdl);
WDF_MEMORY_DESCRIPTOR_INIT_MDL(
                               pInputBuffer,
                               pMdl,
                               BUFFER_LENGTH
                               );

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfmemory.h (einschließen von Wdf.h)
DDI-Complianceregeln	MdlAfterReqCompletedIntIoctlA(kmdf), MdlAfterReqCompletedIoctlA(kmdf), MdlAfterReqCompletedReadA(kmdf), MdlAfterReqCompletedWriteA(kmdf)