KSEVENT_PINCAPS_FORMATCHANGE

Artikel
06/15/2023

Das KSEVENT_PINCAPS_FORMATCHANGE Ereignis gibt dem Audiostapel an, dass sich das Audiodatenformat für das Audiogerät geändert hat.

Nutzungszusammenfassungstabelle

Ziel	Ereignisdeskriptortyp	Ereigniswerttyp
Pin	KSEVENT	KSEVENTDATA

Der Ereigniswerttyp (Vorgangsdaten) ist eine KSEVENTDATA-Struktur , die die für dieses Ereignis zu verwendende Benachrichtigungsmethode angibt.

Bemerkungen

Wenn ein Audioporttreiber die EventHandler-Routine für seinen Miniporttreiber aufruft, übergibt er eine PCEVENT_REQUEST Struktur. Diese Struktur enthält einen Zeiger auf eine PCEVENT_ITEM Struktur, die verwendet wird, um ein Ereignis zu beschreiben, das von einem Filter, einem Pin oder einem Knoten unterstützt wird.

So muss beispielsweise ein Treiber, der das KSEVENT_PINCAPS_FORMATCHANGE Ereignis unterstützt, eine PCEVENT_ITEM Struktur wie folgt auffüllen:

static PCEVENT_ITEM FormatChangePinEvent[] = {
  {
    &KSEVENTSETID_PinCapsChange,
    KSEVENT_PINCAPS_FORMATCHANGE,
    KSEVENT_TYPE_ENABLE | KSEVENT_TYPE_BASICSUPPORT,
    MyEventHandler
  }
};

Im vorherigen Codebeispiel muss der benutzerdefinierte MyEventHandler-Ereignishandler das KSEVENT_PINCAPS_FORMATCHANGE Ereignis überwachen und bei Portcls registrieren, wenn KSEVENT_PINCAPS_FORMATCHANGE ausgelöst wird. Der Miniporttreiber muss die IPortEvents::AddEventToEventList-Methode aufrufen, um das Ereignis zu registrieren.

Um eine Beschreibung der vom Miniporttreiber unterstützten Pins, Knoten, Verbindungen und Eigenschaften abzurufen, ruft der Porttreiber die IMiniport::GetDescription-Methode auf. Dieser Methodenaufruf gibt eine PCFILTER_DESCRIPTOR-Struktur zurück, die auf eine Automatisierungstabelle (PCAUTOMATION_TABLE) verweist. Die PCAUTOMATION_TABLE-Struktur verfügt über ein Ereigniselement . Dieses Element verweist auf ein Array der Ereignisse, die dem Filter zugeordnet sind, den der Miniporttreiber unterstützt. Daher müssen Sie den Member Ereignisse so festlegen, dass er auf das Ereignisarray verweist, das die PCEVENT_ITEM-Struktur für das KSEVENT_PINCAPS_FORMATCHANGE Ereignis enthält.

Wenn der Miniporttreiber eine dynamische Formatänderung erkennt, muss er die IPortEvents::GenerateEventList-Methode aufrufen, um das KSEVENT_PINCAPS_FORMATCHANGE Ereignis zu signalisieren.