Método IKsDeviceFunctions::RegisterAdapterObjectEx (ks.h)
El método IKsDeviceFunctions::RegisterAdapterObjectEx registra un objeto de adaptador DMA con AVStream. Todos los controladores compilados para plataformas Win64 deben usar este método en lugar de KsDeviceRegisterAdapterObject.
Sintaxis
NTSTATUS RegisterAdapterObjectEx(
[in] PADAPTER_OBJECT AdapterObject,
[in] PDEVICE_DESCRIPTION DeviceDescription,
[in] ULONG NumberOfMapRegisters,
[in] ULONG MaxMappingsByteCount,
[in] ULONG MappingTableStride
);
Parámetros
[in] AdapterObject
Puntero al ADAPTER_OBJECT del dispositivo. Debe adquirirse a través de IoGetDmaAdapter antes de llamar a RegisterAdapterObjectEx.
[in] DeviceDescription
Puntero a una estructura de tipo DEVICE_DESCRIPTION que describe los atributos del dispositivo físico para el que el autor de la llamada registra un objeto DMA.
[in] NumberOfMapRegisters
Especifica el número de registros de mapa devueltos desde la llamada del minidriver a IoGetDmaAdapter.
[in] MaxMappingsByteCount
Especifica el número máximo de bytes que el dispositivo puede controlar para una sola asignación. Permite a AVStream dividir automáticamente grandes fragmentos de memoria física contigua en varios elementos de dispersión o recopilación para dispositivos que imponen un límite de tamaño en asignaciones individuales en transferencias DMA. Vea información adicional importante sobre MaxMappingsByteCount en la página de referencia KsDeviceRegisterAdapterObject .
[in] MappingTableStride
Especifica cuántos bytes requiere cada entrada de la tabla de asignación. Este valor debe ser al menos sizeof (KSMAPPING) y puede ser tan grande como sea necesario.
El minidriver puede usar espacio adicional como información de contexto.
Valor devuelto
RegisterAdapterObjectEx devuelve STATUS_SUCCESS si el objeto DMA se registró correctamente. El método devuelve STATUS_INSUFFICIENT_RESOURCES si no hay suficiente memoria disponible.
Comentarios
Consulte también Compatibilidad con DMA en controladores AVStream de 64 bits.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows Server 2003 con Service Pack 1 (SP1) y versiones posteriores de Windows. |
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluye Ks.h) |