struktur GET_LOCAL_HOST_INFO2 (1394.h)

  • Artikel

Struktur GET_LOCAL_HOST_INFO2 berisi data yang dikembalikan oleh permintaan REQUEST_GET_LOCAL_HOST_INFO menggunakan GET_HOST_CAPABILITIES u.GetLocalHostInformation.nLevel .

Sintaks

typedef struct _GET_LOCAL_HOST_INFO2 {
  ULONG HostCapabilities;
  ULONG MaxAsyncReadRequest;
  ULONG MaxAsyncWriteRequest;
} GET_LOCAL_HOST_INFO2, *PGET_LOCAL_HOST_INFO2;

Anggota

HostCapabilities

Menunjukkan kemampuan host. Tabel berikut ini mencantumkan nilai yang bisa ditetapkan ke th adalah anggota:

Bendera Deskripsi
HOST_INFO_PACKET_BASED Pengontrol host mendukung transaksi isochronous berbasis paket.
HOST_INFO_STREAM_BASED Pengontrol host mendukung transaksi isochronous berbasis aliran.
HOST_INFO_SUPPORTS_ISOCH_STRIPPING Pengontrol host mendukung stripping informasi header yang dapat dikonfigurasi.
HOST_INFO_SUPPORTS_START_ON_CYCLE Pengontrol host mendukung sinkronisasi mulai pada waktu siklus isochronous tertentu.
HOST_INFO_SUPPORTS_RETURNING_ISO_HDR Pengontrol host tidak secara otomatis menghapus header paket isochronous.
HOST_INFO_SUPPORTS_ISO_HDR_INSERTION Pengontrol host mendukung bendera DESCRIPTOR_HEADER_SCATTER_GATHER di ISOCH_DESCRIPTOR.
HOST_INFO_SUPPORTS_ISO_DUAL_BUFFER_RX Pengontrol host mendukung bendera RESOURCE_VARIABLE_ISOCH_PAYLOAD di ISOCH_DESCRIPTOR.
HOST_INFO_DMA_DOUBLE_BUFFERING_ENABLED DMA transfer yang dilakukan ke/dari pengontrol host akan di-buffer ganda dengan menggunakan register peta sistem. Register peta sistem membatasi ukuran transfer tunggal. Periksa nilai MaxDmaBufferSize yang dikembalikan dalam struktur GET_LOCAL_HOST_INFO7 oleh permintaan REQUEST_GET_LOCAL_HOST_INFO dan batasi ukuran transfer yang sesuai.

MaxAsyncReadRequest

Driver bus mengisi anggota ini dengan ukuran maksimum permintaan baca asinkron yang didukung pengontrol host.

MaxAsyncWriteRequest

Driver bus mengisi anggota ini dengan ukuran maksimum permintaan tulis asinkron yang didukung pengontrol host.

Keterangan

Driver port yang mengembalikan bendera HOST_INFO_PACKET_BASED mendukung bendera RESOURCE_USE_PACKET_BASED permintaan IsochAllocateResources. Driver port yang mengembalikan bendera HOST_STREAM_PACKET_BASED mendukung I/O berbasis aliran. Jika pengontrol host tidak mendukung I/O berbasis aliran, driver harus menggunakan I/O berbasis paket, dan mengatur bendera RESOURCE_USE_PACKET_BASED saat mengeluarkan REQUEST_ISOCH_ALLOCATE_RESOURCES.

Beberapa pengontrol host secara otomatis menghapus header paket dari paket isochronous. Jika pengontrol host tidak secara otomatis menghapus header, driver port mengembalikan bendera HOST_INFO_SUPPORTS_ISO_HDR. Beberapa pengontrol host memungkinkan driver untuk mengonfigurasi pengontrol host untuk menghapus sejumlah quadlet tertentu; untuk pengontrol tersebut, driver port mengembalikan bendera HOST_INFO_SUPPORTS_ISOCH_STRIPPING. Driver harus memeriksa bendera ini sebelum memanggil REQUEST_ISOCH_ALLOCATE_RESOURCES dengan bendera RESOURCE_STRIP_ADDITIONAL_QUADLETS.

Jika pengontrol host mendukung sinkronisasi REQUEST_ISOCH_LISTEN dan REQUEST_ISOCH_TALK permintaan ke waktu siklus isochronous, driver port mengembalikan HOST_INFO_SUPPORTS_START_ON_CYCLE. Driver harus memeriksa bendera ini sebelum mencoba mengeluarkan permintaan REQUEST_ISOCH_ALLOCATE_RESOURCES menggunakan bendera RESOURCE_SYNCH_ON_TIME, atau sebelum melampirkan buffer yang ISOCH_DESCRIPTOR nya memiliki bendera DESCRIPTOR_SYNCH_ON_TIME yang ditetapkan.

Persyaratan

Persyaratan Nilai
Header 1394.h (termasuk 1394.h)

Lihat juga

GET_LOCAL_HOST_INFO7

ISOCH_DESCRIPTOR

REQUEST_GET_LOCAL_HOST_INFO

REQUEST_ISOCH_ALLOCATE_RESOURCES