IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR IOCTL (sidebandaudio.h)
Der Audiotreiber gibt die IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR aus, um Informationen zu einer aktivierten Randband-Audiogeräteschnittstelle abzurufen. Dies gibt insbesondere die Anzahl der Audioendpunkte zurück, die auf einem Gerät verfügbar sind, das Sideband unterstützt. Diese Informationen werden in einer Audiogerätebeschreibung Struktur zurückgegeben.
Hauptcode
Eingabepuffer
NULL.
Eingabepufferlänge
Ausgabepuffer
Ein Puffer, der eine SIDEBANDAUDIO_DEVICE_DESCRIPTOR Struktur enthält.
Länge des Ausgabepuffers
Die Größe einer SIDEBANDAUDIO_DEVICE_DESCRIPTOR Struktur.
Statusblock
Wenn die Routine erfolgreich ist, wird status auf STATUS_SUCCESS festgelegt, und das Information Member ist die Anzahl der Bytes, die die Routine in den Ausgabepuffer schreibt.
Wenn der Status auf STATUS_BUFFER_TOO_SMALL festgelegt ist, sollte der Audiotreiber das Information Member lesen, um die Größe des Puffers abzurufen, den der Aufrufer für diese Anforderung zuordnen soll.
Bemerkungen
Diese IOCTL kann nur im Kernelmodus aufgerufen werden.
Der Audiotreiber sendet diese Anforderung, um Informationen über eine aktivierte Audio sideband-Geräteschnittstelle zu erhalten. Die Informationen ändern sich nicht, während die Schnittstelle aktiviert ist, können sich aber ändern, während die Schnittstelle deaktiviert ist. Der Audiotreiber sendet diese Anforderung kurz nach dem Ermitteln einer aktivierten Sideband-Audiogeräteschnittstelle und verwendet die Informationen, um zu bestimmen, wie viele Sideband-Audioendpunkte verfügbar sind.
Der Audiotreiber sendet diese Anforderung einmal mit einer Ausgabepuffergröße von Null (0), um die erforderliche Ausgabepuffergröße zu ermitteln. In diesem Fall wird die Anforderung mit status STATUS_BUFFER_TOO_SMALL abgeschlossen und das Information Member auf die erforderliche Puffergröße festgelegt. Der Audiotreiber weist dann den erforderlichen Speicherplatz zu und sendet die Anforderung erneut. In der Regel speichert ein Audiotreiber einen Zeiger auf diesen Speicherort im Gerätekontext, um während der späteren Aktivität referenzieren zu können.
Der Audiotreiber kann dann iterativ jede Endpunktfunktion mit dem IOCTL-IOCTL_SBAUD_GET_ENDPOINT_DESCRIPTORbestimmen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | sidebandaudio.h |