SPB_TRANSFER_BUFFER-Struktur (spb.h)

  • Artikel

Die SPB_TRANSFER_BUFFER-Struktur beschreibt den Datenpuffer für eine einzelne Übertragung in einer E/A-Übertragungssequenz.

Syntax

typedef struct SPB_TRANSFER_BUFFER {
  SPB_TRANSFER_BUFFER_FORMAT Format;
  union {
    SPB_TRANSFER_BUFFER_LIST_ENTRY Simple;
    struct {
      PSPB_TRANSFER_BUFFER_LIST_ENTRY List;
      ULONG                           ListCe;
    } BufferList;
    PMDL                           Mdl;
  };
} SPB_TRANSFER_BUFFER, *PSPB_TRANSFER_BUFFER;

Member

Format

Das Pufferformat. Dieses Element ist auf einen der folgenden SPB_TRANSFER_BUFFER_FORMAT Enumerationswerte festgelegt:

  • SpbTransferBufferFormatSimple
  • SpbTransferBufferFormatList
  • SpbTransferBufferFormatSimpleNonPaged
  • SpbTransferBufferFormatMdl

SpbTransferBufferFormatMdl ist ein gültiger Wert nur für E/A-Übertragungssequenzen, die von Clients des SPB-Controllertreibers angefordert werden, die Kernelmoduskomponenten sind.

Simple

Eine SPB_TRANSFER_BUFFER_LIST_ENTRY-Struktur, die die Basisadresse und die Länge eines einfachen Übertragungspuffers angibt. Verwenden Sie dieses Element der Union, wenn FormatSpbTransferBufferFormatSimple oder SpbTransferBufferFormatSimpleNonPaged ist. Das SpbTransferBufferFormatSimpleNonPaged-Format wird nur von Kernelmodusclients verwendet.

BufferList

Eine Punktsammlungsliste, die aus einem Array von Pufferdeskriptoren besteht. Verwenden Sie dieses Element der Union, wenn FormatSpbTransferBufferFormatList ist.

BufferList.List

Ein Zeiger auf ein Array von SPB_TRANSFER_BUFFER_LIST_ENTRY Strukturen, die die Puffer in der Punktsammlungsliste beschreiben.

BufferList.ListCe

Die Anzahl der Elemente im Listenarray .

Mdl

Ein Zeiger auf eine MDL, die den Puffer beschreibt. Dieses Element wird nur von Kernelmodusclients verwendet. Verwenden Sie dieses Element der Union, wenn FormatSpbTransferBufferFormatMdl ist. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

Diese Struktur wird von einer SPB_TRANSFER_LIST_ENTRY-Struktur verwendet, um einen Übertragungspuffer zu beschreiben.

Das Mdl-Element dieser Struktur kann nur von Clients des SPB-Controllertreibers verwendet werden, die Kernelmoduskomponenten sind. Benutzermodusclients dürfen diesen Member nicht verwenden. Weitere Informationen zu MDLs finden Sie unter Verwenden von MDLs.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Wird ab Windows 8 unterstützt.
Kopfzeile spb.h

Weitere Informationen