Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu makalede, Microsoft tarafından sağlanan USB ana bilgisayar denetleyicisi uzantısı (UCX) ile iletişim kuran bir Evrensel Seri Veri Yolu (USB) ana bilgisayar denetleyicisi sürücüsü geliştirmeye yönelik Windows işletim sistemi desteği açıklanmaktadır.
Belirtim ile uyumlu olmayan bir xHCI konak denetleyicisi geliştiriyorsanız veya özel bir xHCI olmayan donanım (sanal konak denetleyicisi gibi) geliştiriyorsanız, UCX ile iletişim kuran bir konak denetleyicisi sürücüsü yazabilirsiniz. Örneğin, USB cihazlarını destekleyen bir kablosuz takma birimi düşünün. Bilgisayar, TCP üzerinden USB kullanarak kablosuz bağlantı istasyonu aracılığıyla USB cihazlarıyla iletişim kurar.
USB ana bilgisayar denetleyicisi uzantısı (UCX)
USB ana bilgisayar denetleyicisi uzantısı, sistem tarafından sağlanan bir sürücüdür (Ucx01000.sys). Bu sürücü, Windows Driver Framework programlama arabirimleri kullanılarak bir çerçeve sınıfı uzantısı olarak uygulanır. Konak denetleyicisi sürücüsü, bu sınıf uzantısının istemci sürücüsü olarak görev alır. Konak denetleyicisi sürücüsü donanım işlemlerini ve olaylarını, güç yönetimini ve PnP olaylarını işlerken, UCX konak denetleyicisi sürücüsüne yönelik istekleri kuyruğa alan ve diğer görevleri gerçekleştiren soyut bir arabirim görevi görür.
UCX, Windows 'dakiUSB ana bilgisayar tarafı sürücülerinden biridir. Konak denetleyici aygıt yığınında FDO olarak yüklenir.
USB ana bilgisayar denetleyicisi sürücüsü
UCX genişletilebilir ve çeşitli konak denetleyicisi sürücülerini destekleyecek şekilde tasarlanmıştır. Windows, USB xHCI konak denetleyicilerini hedefleyen bir xHCI sürücüsü (Usbxhci.sys) sağlar.
Ana bilgisayar denetleyicisi sürücüsü, Kernel-Mode Driver Framework (KMDF) sürücüsü olarak yazılmış bir UCX istemcisidir.
Microsoft tarafından sağlanan ikililer
Ana denetleyici sürücüsü yazmak için UCX (Ucx01000.sys) ve iskelet kitaplığı (Ucx01000.lib) gereklidir. Saplama kütüphanesi Windows Sürücü Seti'nde (WDK) yer alır. Kitaplık iki ana işlev gerçekleştirir.
- Konak denetleyicisi sürücüsü tarafından yapılan çağrıları çevirin ve UCX'e geçirin.
- Sürüm oluşturma desteği sağlar. Bir konak denetleyicisi sürücüsü, yalnızca UCX ana bilgisayar denetleyicisi sürücüsüyle aynı Ana sürüm numarasına ve konak denetleyicisi sürücüsüyle aynı veya daha yüksek İkincil sürüm numarasına sahipse UCX ile çalışır.
Geliştirme araçları
WDK, sürücü geliştirme için gereken kaynaklar olarak başlık dosyaları, kütüphaneler, araçlar ve örnekler gibi unsurları içerir.
Windows için setleri ve araçları indirme
Başlayın
Mimarinin farklı bileşenlerinin (cihaz, konak denetleyicisi ve hub) beklenen davranışını açıklayan resmi belirtimi okuyun.
Evrensel Seri Veri Yolu için xHCI: Belirtim
Resmi Evrensel Seri Veri Yolu Belgeleri
UCX mimarisini anlama
Microsoft tarafından sağlanan USB sürücü yığını hakkında bilgi edinin:
Windows'da 'deki USB ana bilgisayar sürücüleri
Mimarisi: USB ana bilgisayar denetleyicisi uzantısı (UCX)
UCX nesneleri ve referansları hakkında bilgi sahibi olun
UCX, kendi USB'ye özgü UCX nesnelerini tanımlamak için WDF nesne işlevselliğini genişletir. WDF nesneleri hakkında daha fazla ayrıntı için bkz. Framework Nesnelerine Giriş.
UCX, altındaki herhangi bir konak denetleyici sürücüsüne yönelik istekleri kuyruğa almak için bu nesneleri kullanır. Daha fazla bilgi için bkz. bir konak denetleyicisi sürücüsü tarafından kullanılan UCX nesnelerini ve tanıtıcılarını.
| UCX nesnesi | Açıklama |
|---|---|
| Konak denetleyicisi nesnesi (UCXCONTROLLER) | Ana bilgisayar denetleyicisi sürücüsü tarafından oluşturulan ana bilgisayar denetleyicisini temsil eder. Sürücü, konak denetleyicisi örneği başına yalnızca bir konak denetleyicisi nesnesi oluşturmalıdır. Genellikle UcxControllerCreate yöntemini çağırarak EVT_WDF_DRIVER_DEVICE_ADD geri çağırma içinde oluşturulur. |
| Kök hub nesnesi (UCXROOTHUB) | Konak denetleyicisinin kök bağlantı noktalarının durumunu alır ve denetler. Host denetleyici sürücüsü tarafından genellikle UcxRootHubCreate yöntemini çağırarak EVT_WDF_DRIVER_DEVICE_ADD geri çağırma içinde oluşturulur. |
| USB cihaz nesnesi (UCXUSBDEVICE) | Veri yolu ile bağlantılı fiziksel bir USB cihazını temsil eder. Konak denetleyicisi sürücüsü tarafından genellikle **UcxUsbDeviceCreate yöntemi çağrılarak EVT_UCX_CONTROLLER_USBDEVICE_ADD geri çağırma içinde oluşturulur. |
| Uç nokta nesnesi (UCXENDPOINT) | USB cihaz nesnesinde bir uç noktayı temsil eder. Konak denetleyicisi sürücüsü tarafından genellikle **UcxEndpointCreate yöntemini çağırarak EVT_UCX_USBDEVICE_DEFAULT_ENDPOINT_ADD veya EVT_UCX_USBDEVICE_ENDPOINT_ADD geri çağırma içinde oluşturulur. |
| Stream nesnesi (UCXSTREAMS) | Tek bir toplu uç nokta üzerinden cihaza bir dizi boruyu temsil eder. Konak denetleyicisi sürücüsü tarafından genellikle UcxStaticStreamsCreate yöntemini çağırarak EVT_UCX_ENDPOINT_STATIC_STREAMS_ADD geri çağırma içinde oluşturulur. |
Belge bölümleri
Ana bilgisayar denetleyicisi sürücüsünün kök hub geri çağırma işlevleri
UCX, kök hub ile ilgili işlemlerin çoğunu işler. Bu, USB hub sürücüsünün kök hub ile normal hub ile etkileşimde olduğu gibi etkileşim kurmasına olanak tanır. Ana denetleyici sürücüsü geri çağırma işlevlerini kaydedebilir.
USB ana bilgisayar denetleyicisi sürücüsünde G/Ç isteklerini işleme
UCX, gelen USB istek bloklarını (URL' ler) öncelik sırasına ekler ve bunları doğru uç nokta kuyruğuna iletir.
Bir konak denetleyicisi sürücüsünde USB uç noktalarını yapılandırma
Konak denetleyicisi sürücüsü, UCX'in uç noktalarıyla ilişkili kuyrukların yönetiminde ve uç noktaların denetleyici donanımına programlamasında rol oynar.
USB ana denetleyici uzantısı (UCX) referansı
İstemci sürücüsü tarafından kullanılan G/Ç istekleri, destek yordamları, yapılar ve arabirimler için belirtimler sağlar. Bu yordamlar ve ilgili veri yapıları WDK üst bilgilerinde tanımlanır.
UCX, frameworksınıf uzantısı olarak adlandırılır.
Konak denetleyicisi sürücüsü, istemci sürücüsü olarak adlandırılır.