KSPROPERTY_RTAUDIO_SETWRITEPACKET
KSPROPERTY_RTAUDIO_SETWRITEPACKET informiert den Treiber darüber, dass das Betriebssystem gültige Daten in den WaveRT-Puffer geschrieben hat.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
| Nein | Ja | Pin | KSPROPERTY | KSRTAUDIO_SETWRITEPACKET_INFO |
Der Eigenschaftendeskriptor (instance Daten) ist eine KSPROPERTY-Struktur. Vor dem Senden der Anforderung lädt der Client die -Struktur mit Werten, die die Paketnummer, die Paketlänge und andere Informationen enthalten.
Der Eigenschaftswert ist eine Struktur vom Typ KSRTAUDIO_SETWRITEPACKET_INFO.
Rückgabewert
Eine KSPROPERTY_RTAUDIO_SETWRITEPACKET-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen geeigneten Fehler status Code zurück.
Bemerkungen
Wenn diese KSPROPERTY unterstützt wird, kann der Treiber optional die bereitgestellten Informationen verwenden, um die Hardwareübertragung zu optimieren. Beispielsweise kann der Treiber DMA-Übertragungen optimieren oder Hardware so programmieren, dass die Übertragung am Ende des angegebenen Pakets beendet wird, falls das Betriebssystem diese Routine nicht erneut aufruft, um den Treiber über ein anderes Paket zu informieren. Dadurch können hörbare Auswirkungen des Unterlaufs abgemildert werden, z. B. das Einführen einer hörbaren Lücke anstelle der Wiederholung eines kreisförmigen Puffers. Der Treiber ist jedoch weiterhin verpflichtet, seinen internen Paketzähler zu erhöhen und Benachrichtigungsereignisse mit einer nominalen Echtzeitrate zu signalisieren.
Außer wenn das Betriebssystem das flag KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM angibt, entspricht die Paketgröße der WaveRT-Puffergröße dividiert durch den an KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION übergebenen NotificationCount.
Abhängig von den Hardwarefunktionen kann der Treiber, wenn das flag KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM angegeben wird, einen Teil des WaveRT-Puffers stilllegen, der dem EOS-Paket folgt, falls die Hardware Daten über die EOS-Position hinaus überträgt.
Requirements (Anforderungen)
Version |
Verfügbar in windows-Betriebssystemen Windows 10 und höher. |
Header |
Ksmedia.h |