IOCTL_UCMTCPCI_PORT_CONTROLLER_GET_STATUS IOCTL (ucmtcpciportcontrollerrequests.h)

Artikel
08/07/2023

Mendapatkan nilai dari semua register status sesuai Spesifikasi Antarmuka Pengontrol Port Universal Serial Bus Type-C. Driver klien harus mengambil nilai register CC_STATUS, POWER_STATUS, dan FAULT_STATUS.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Penunjuk ke struktur UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS yang berisi semua nilai register kontrol. Untuk mendapatkan struktur, panggil WdfRequestRetrieveInputBuffer dengan meneruskan objek permintaan kerangka kerja yang diterima.

Panjang buffer input

Ukuran struktur UCMTCPCI_PORT_CONTROLLER_GET_STATUS_IN_PARAMS .

Buffer output

Penunjuk ke struktur UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS . Untuk mendapatkan struktur, panggil WdfRequestRetrieveOutputBuffer dengan meneruskan objek permintaan kerangka kerja yang diterima.

Panjang buffer output

Ukuran struktur UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS .

Blok status

Irp->IoStatus.Status diatur ke STATUS_SUCCESS jika permintaan berhasil. Jika tidak, Status ke kondisi kesalahan yang sesuai sebagai kode NTSTATUS .

Keterangan

Ekstensi kelas UcmTcpciCx mengirimkan permintaan IOCTL ini untuk mengambil nilai register status. Driver klien harus berkomunikasi dengan pengontrol port untuk mengambil nilai register dan mengisi struktur UCMTCPCI_PORT_CONTROLLER_GET_STATUS_OUT_PARAMS yang diterima dengan nilai-nilai tersebut. Untuk menyelesaikan permintaan, driver harus mengatur struktur yang diisi pada objek permintaan kerangka kerja dengan memanggil WdfRequestSetInformation lalu memanggil WdfRequestComplete untuk menyelesaikan permintaan.