Método IPortClsNotifications::AllocNotificationBuffer (portcls.h)

Asigna un búfer del tamaño especificado, en el grupo de memoria especificado, para su uso en el envío de notificaciones, para permitir comunicaciones entre módulos de audio y aplicaciones para UWP.

Para obtener más información sobre los módulos de audio, consulte Implementación de la detección de módulos de audio.

Sintaxis

NTSTATUS AllocNotificationBuffer(
  [in]  POOL_TYPE              PoolType,
  [in]  USHORT                 NumberOfBytes,
  [out] PPCNOTIFICATION_BUFFER *NotificationBuffer
);

Parámetros

[in] PoolType

Especifica el tipo de grupo de memoria desde el que se va a asignar el objeto (vea POOL_TYPE). Los valores recomendados son NonPagedPoolNx o PagedPool. La selección del tipo de grupo de memoria también depende del nivel IRQL. Si se ejecuta en DISPATCH_LEVEL la memoria debe no estar paginada.

[in] NumberOfBytes

Número de bytes que se van a asignar.

[out] NotificationBuffer

Puntero a un PCNOTIFICATION_BUFFER que el método escribe la dirección de la notificación asignada.

Valor devuelto

STATUS_SUCCESS: el controlador pudo asignar el búfer de notificaciones.

STATUS_INVALID_PARAMETER: el controlador devuelve este error si encuentra algún otro parámetro no válido, aparte de los casos específicos de otras instancias de estado de error.

Se pueden devolver códigos de estado estándar adicionales. Por ejemplo, STATUS_INSUFFICIENT_RESOURCES se devolverá si no es posible asignar el búfer necesario.

Comentarios

Los autores de llamadas de AllocNotificationBuffer deben ejecutarse en IRQL <= DISPATCH_LEVEL. Si un escritor de controladores llama a esta rutina en IRQL = DISPATCH_LEVEL, notificationStructure debe asignarse desde la memoria no paginada.

Requisitos

Consulte también

IPortClsNotifications