Fungsi UfxEndpointCreate (ufxclient.h)
Membuat objek titik akhir.
Sintaks
NTSTATUS UfxEndpointCreate(
[in] UFXDEVICE UfxDevice,
[in, out] PUFXENDPOINT_INIT EndpointInit,
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[in] PWDF_IO_QUEUE_CONFIG TransferQueueConfig,
[in, optional] PWDF_OBJECT_ATTRIBUTES TransferQueueAttributes,
[in] PWDF_IO_QUEUE_CONFIG CommandQueueConfig,
[in, optional] PWDF_OBJECT_ATTRIBUTES CommandQueueAttributes,
[out] UFXENDPOINT *UfxEndpoint
);
Parameter
[in] UfxDevice
Handel ke objek perangkat UFX yang dibuat driver dengan memanggil UfxDeviceCreate.
[in, out] EndpointInit
Struktur buram yang diteruskan oleh UFX dalam panggilan ke EVT_UFX_DEVICE_ENDPOINT_ADD atau EVT_UFX_DEVICE_DEFAULT_ENDPOINT_ADD.
[in, optional] Attributes
Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan pemanggil. Struktur ini harus diinisialisasi dengan WDF_OBJECT_ATTRIBUTES_INIT atau WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.
[in] TransferQueueConfig
Penunjuk ke pemanggil yang dialokasikan WDF_IO_QUEUE_CONFIG struktur. Struktur ini harus diinisialisasi dengan WDF_IO_QUEUE_CONFIG_INIT.
[in, optional] TransferQueueAttributes
Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan pemanggil. Struktur ini harus diinisialisasi dengan WDF_OBJECT_ATTRIBUTES_INIT atau WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.
[in] CommandQueueConfig
Penunjuk ke pemanggil yang dialokasikan WDF_IO_QUEUE_CONFIG struktur. Struktur ini harus diinisialisasi dengan WDF_IO_QUEUE_CONFIG_INIT.
[in, optional] CommandQueueAttributes
Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan pemanggil. Struktur ini harus diinisialisasi dengan WDF_OBJECT_ATTRIBUTES_INIT atau WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.
[out] UfxEndpoint
Penunjuk ke lokasi yang menerima handel ke objek UFXENDPOINT.
Mengembalikan nilai
Jika operasi berhasil, metode mengembalikan STATUS_SUCCESS, atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE. Jika tidak, ia mengembalikan nilai status yang NT_SUCCESS(status) sama dengan FALSE.
Keterangan
Antrean transfer menangani IOCTL berikut yang terkait dengan transfer titik akhir:
- IOCTL_INTERNAL_USBFN_CONTROL_STATUS_HANDSHAKE_IN
- IOCTL_INTERNAL_USBFN_CONTROL_STATUS_HANDSHAKE_OUT
- IOCTL_INTERNAL_USBFN_TRANSFER_IN
- IOCTL_INTERNAL_USBFN_TRANSFER_IN_APPEND_ZERO_PKT
- IOCTL_INTERNAL_USBFN_TRANSFER_OUT
Antrean perintah akan menangani IOCTL berikut:
- IOCTL_INTERNAL_USBFN_GET_PIPE_STATE
- IOCTL_INTERNAL_USBFN_SET_PIPE_STATE
- IOCTL_INTERNAL_USBFN_DESCRIPTOR_UPDATE
NTSTATUS
UfxEndpointAdd (
_In_ UFXDEVICE Device,
_In_ PUSB_ENDPOINT_DESCRIPTOR Descriptor,
_Inout_ PUFXENDPOINT_INIT EndpointInit
)
/*++
Routine Description:
Creates a UFXENDPOINT object, and initializes its contexts.
Parameters Description:
Device - UFXDEVICE associated with the endpoint.
Descriptor - Endpoint descriptor for this endpoint.
EndpointInit - Opaque structure from UFX.
Return Value:
STATUS_SUCCESS if successful, appropriate NTSTATUS message otherwise.
--*/
{
NTSTATUS Status;
WDF_OBJECT_ATTRIBUTES Attributes;
WDF_IO_QUEUE_CONFIG TransferQueueConfig;
WDF_OBJECT_ATTRIBUTES TransferQueueAttributes;
WDF_IO_QUEUE_CONFIG CommandQueueConfig;
WDF_OBJECT_ATTRIBUTES CommandQueueAttributes;
UFXENDPOINT Endpoint;
PUFXENDPOINT_CONTEXT EpContext;
PUFXDEVICE_CONTEXT DeviceContext;
UFX_ENDPOINT_CALLBACKS Callbacks;
PENDPOINT_QUEUE_CONTEXT QueueContext;
WDFQUEUE Queue;
TraceEntry();
DeviceContext = UfxDeviceGetContext(Device);
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&Attributes, UFXENDPOINT_CONTEXT);
Attributes.ExecutionLevel = WdfExecutionLevelPassive;
Attributes.EvtCleanupCallback = UfxEndpoint_Cleanup;
//
// Note: Execution level needs to be passive to avoid deadlocks with WdfRequestComplete.
//
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&TransferQueueAttributes, ENDPOINT_QUEUE_CONTEXT);
TransferQueueAttributes.ExecutionLevel = WdfExecutionLevelPassive;
WDF_IO_QUEUE_CONFIG_INIT(&TransferQueueConfig, WdfIoQueueDispatchManual);
TransferQueueConfig.AllowZeroLengthRequests = TRUE;
TransferQueueConfig.EvtIoStop = EndpointQueue_EvtIoStop;
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&CommandQueueAttributes, ENDPOINT_QUEUE_CONTEXT);
CommandQueueAttributes.ExecutionLevel = WdfExecutionLevelPassive;
WDF_IO_QUEUE_CONFIG_INIT(&CommandQueueConfig, WdfIoQueueDispatchSequential);
CommandQueueConfig.EvtIoInternalDeviceControl = EvtEndpointCommandQueue;
UFX_ENDPOINT_CALLBACKS_INIT(&Callbacks);
UfxEndpointInitSetEventCallbacks(EndpointInit, &Callbacks);
Status = UfxEndpointCreate(
Device,
EndpointInit,
&Attributes,
&TransferQueueConfig,
&TransferQueueAttributes,
&CommandQueueConfig,
&CommandQueueAttributes,
&Endpoint);
CHK_NT_MSG(Status, "Failed to create ufxendpoint!");
Status = WdfCollectionAdd(DeviceContext->Endpoints, Endpoint);
CHK_NT_MSG(Status, "Failed to add endpoint to collection!");
EpContext = UfxEndpointGetContext(Endpoint);
EpContext->UfxDevice = Device;
EpContext->WdfDevice = DeviceContext->FdoWdfDevice;
RtlCopyMemory(&EpContext->Descriptor, Descriptor, sizeof(*Descriptor));
Queue = UfxEndpointGetTransferQueue(Endpoint);
QueueContext = EndpointQueueGetContext(Queue);
QueueContext->Endpoint = Endpoint;
Queue = UfxEndpointGetCommandQueue(Endpoint);
QueueContext = EndpointQueueGetContext(Queue);
QueueContext->Endpoint = Endpoint;
Status = TransferInitialize(Endpoint);
CHK_NT_MSG(Status, "Failed to initialize endpoint transfers");
//
// This can happen if we're handling a SetInterface command.
//
if (DeviceContext->UsbState == UsbfnDeviceStateConfigured) {
UfxEndpointConfigure(Endpoint);
}
Status = WdfIoQueueReadyNotify(
UfxEndpointGetTransferQueue(Endpoint),
TransferReadyNotify,
Endpoint);
CHK_NT_MSG(Status, "Failed to register ready notify");
End:
TraceExit();
return Status;
}
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 10 |
Target Platform | Windows |
Header | ufxclient.h |
Pustaka | ufxstub.lib |
IRQL | PASSIVE_LEVEL |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk