funzione WDF_MEMORY_DESCRIPTOR_INIT_MDL (wdfmemory.h)

Articolo
02/29/2024

[Si applica a KMDF e UMDF]

La funzione WDF_MEMORY_DESCRIPTOR_INIT_MDL inizializza una struttura WDF_MEMORY_DESCRIPTOR in modo da descrivere un elenco di descrittori di memoria specificato (MDL).

Sintassi

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

Parametri

[out] Descriptor

Puntatore a una struttura WDF_MEMORY_DESCRIPTOR .

[in] Mdl

Puntatore a un MDL che descrive un buffer.

[in] BufferLength

Dimensioni, in byte, del buffer specificato da Mdl .

Valore restituito

nessuno

Osservazioni

La funzione WDF_MEMORY_DESCRIPTOR_INIT_MDL zero la struttura di WDF_MEMORY_DESCRIPTOR specificata e imposta il membro Type della struttura su WdfMemoryDescriptorTypeMdl. Imposta quindi i membri u.MdlType.Mdl.Mdl e u.MdlType.BufferLength sui valori specificati rispettivamente dai parametri Mdl e BufferLength.

Esempio

Nell'esempio di codice seguente viene allocato un buffer, viene creato un MDL per il buffer e viene usato MDL per inizializzare una struttura WDF_MEMORY_DESCRIPTOR .

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfmemory.h (include Wdf.h)
Regole di conformità DDI	MdlAfterReqCompletedIntIoctlA(kmdf), MdlAfterReqCompletedIoctlA(kmdf), MdlAfterReqCompletedReadA(kmdf), MdlAfterReqCompletedWriteA(kmdf)