Función WdfDmaEnablerGetFragmentLength (wdfdmaenabler.h)
[Solo se aplica a KMDF]
El método WdfDmaEnablerGetFragmentLength devuelve la longitud máxima de transferencia que admite el sistema operativo para una única transferencia DMA.
Sintaxis
size_t WdfDmaEnablerGetFragmentLength(
[in] WDFDMAENABLER DmaEnabler,
[in] WDF_DMA_DIRECTION DmaDirection
);
Parámetros
[in] DmaEnabler
Identificador de un objeto de habilitador DMA que el controlador obtuvo de una llamada anterior a WdfDmaEnablerCreate.
[in] DmaDirection
Valor WDF_DMA_DIRECTION con tipo que especifica la dirección de la operación de transferencia de DMA. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
Valor devuelto
WdfDmaEnablerGetFragmentLength devuelve la longitud máxima de una transferencia DMA, en bytes, que el sistema operativo puede admitir o cero si el valor del parámetro DmaDirection no es válido.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Comentarios
La longitud máxima de transferencia de DMA que el sistema operativo puede admitir depende del número de registros de mapa disponibles. Si hay suficientes registros de mapa disponibles, WdfDmaEnablerGetFragmentLength devuelve el mismo valor que devuelve WdfDmaEnablerGetMaximumLength . De lo contrario, el valor que devuelve WdfDmaEnablerGetFragmentLength será menor que el valor que devuelve WdfDmaEnablerGetMaximumLength .
El controlador puede determinar el número de registros de mapa disponibles mediante la macro BYTE_TO_PAGES, como se indica a continuación:
BYTE_TO_PAGES(WdfDmaEnablerGetFragmentLength()) + 1
Si el controlador especificó un perfil dúplex cuando llamó a WdfDmaEnablerCreate, el valor del parámetro DmaDirection debe ser WdfDmaDirectionReadFromDevice para obtener la longitud máxima de transferencia para las operaciones de lectura y WdfDmaDirectionWriteToDevice para obtener la longitud máxima de transferencia para las operaciones de escritura. Si el controlador no ha especificado un perfil dúplex, el controlador puede especificar WdfDmaDirectionReadFromDevice o WdfDmaDirectionWriteToDevice para DmaDirection.
Tenga en cuenta que si el dispositivo del controlador admite la operación dúplex, WdfDmaEnablerGetFragmentLength puede devolver valores diferentes para las instrucciones de lectura y escritura que especifica el parámetro DmaDirection . Esta diferencia se debe a que el marco crea un objeto de adaptador independiente para cada dirección y el sistema operativo puede proporcionar un número diferente de registros de mapa a cada objeto de adaptador.
Ejemplos
En el ejemplo de código siguiente se determina el número mínimo de registros de mapa necesarios para controlar las operaciones de lectura de un dispositivo NIC, se calcula el número de registros de mapa disponibles y se notifica un error si el número de registros de mapa asignados no es suficiente.
ULONG minimumMapRegisters;
ULONG maxLengthSupported;
ULONG mapRegistersAllocated;
miniMapRegisters = BYTES_TO_PAGES(NIC_MAX_PACKET_SIZE) + 1;
maxLengthSupported =
(ULONG) WdfDmaEnablerGetFragmentLength(
FdoData->WdfDmaEnabler,
WdfDmaDirectionReadFromDevice
);
mapRegistersAllocated = BYTES_TO_PAGES(maxLengthSupported) + 1;
if (mapRegistersAllocated < minimumMapRegisters) {
status = STATUS_INSUFFICIENT_RESOURCES;
return status;
}
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.1 |
| Encabezado | wdfdmaenabler.h (incluya Wdf.h) |
| Library | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| IRQL | <=DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |