IPortClsNotifications::AllocNotificationBuffer-Methode (portcls.h)

  • Artikel

Weist einen Puffer der angegebenen Größe im angegebenen Speicherpool für die Verwendung beim Senden von Benachrichtigungen zu, um die Kommunikation zwischen Audiomodulen und UWP-Apps zu ermöglichen.

Weitere Informationen zu Audiomodulen finden Sie unter Implementieren der Audiomodulermittlung.

Syntax

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

Parameter

[in] PoolType

Gibt den Typ des Speicherpools an, aus dem das Objekt zugeordnet werden soll (siehe POOL_TYPE). Die empfohlenen Werte sind NonPagedPoolNx oder PagedPool. Die Auswahl des Speicherpooltyps hängt auch von der IRQL-Ebene ab. Bei Ausführung auf DISPATCH_LEVEL muss der Arbeitsspeicher nicht ausgelagert sein.

[in] NumberOfBytes

Anzahl der zuzuordnenden Bytes.

[out] NotificationBuffer

Zeiger auf einen PCNOTIFICATION_BUFFER , bei dem die -Methode die Adresse der zugewiesenen Benachrichtigung schreibt.

Rückgabewert

STATUS_SUCCESS: Der Treiber konnte den Benachrichtigungspuffer zuordnen.

STATUS_INVALID_PARAMETER : Der Treiber gibt diesen Fehler zurück, wenn er einen anderen Parameter ungültig findet, abgesehen von den spezifischen Fällen für andere Fehler status Instanzen.

Es können zusätzliche Standard-status-Codes zurückgegeben werden. Beispielsweise werden STATUS_INSUFFICIENT_RESOURCES zurückgegeben, wenn es nicht möglich ist, den erforderlichen Puffer zuzuweisen.

Hinweise

Aufrufer von AllocNotificationBuffer müssen unter IRQL <= DISPATCH_LEVEL ausgeführt werden. Wenn ein Treiberschreiber diese Routine unter IRQL = DISPATCH_LEVEL aufruft, muss die NotificationStructure aus dem nicht ausgestellten Arbeitsspeicher zugeordnet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 10 Version 1703 und höher von Windows.
Zielplattform Universell
Header portcls.h (include Portcls.h)
Bibliothek Portcls.lib
IRQL <= DISPATCH_LEVEL (siehe Abschnitt Hinweise)

Weitere Informationen

IPortClsNotifications