Uzyskiwanie informacji o programie WDM

[Dotyczy tylko usługi KMDF]

Platforma udostępnia kilka metod obiektów, które umożliwiają sterownikowi uzyskanie informacji zdefiniowanych przez program WDM.

Uzyskiwanie informacji WDM o sterowniku i jego urządzeniach

Aby uzyskać informacje WDM o sterowniku i jego urządzeniach, sterownik może wywołać następujące metody:

WdfFdoInitWdmGetPhysicalDevice
Pobiera strukturę DEVICE_OBJECT reprezentującą obiekt urządzenia fizycznego (PDO). Sterownik może wywołać tę metodę, zanim sterownik utworzył obiekt urządzenia struktury dla urządzenia.

WdfDeviceWdmGetPhysicalDevice
Pobiera strukturę WDM DEVICE_OBJECT, która reprezentuje PDO urządzenia. Sterownik może wywołać tę metodę po utworzeniu obiektu urządzenia frameworku dla urządzenia.

WdfDeviceWdmGetDeviceObject
Zwraca obiekt urządzenia WDM skojarzony z określonym obiektem urządzenia platformy.

WdfDeviceWdmGetAttachedDevice
Zwraca kolejny niższy obiekt urządzenia WDM w stosie urządzeń.

WdfWdmDeviceGetWdfDeviceHandle
Zwraca uchwyt do obiektu urządzenia frameworku skojarzonego z określonym obiektem urządzenia WDM.

WdfWdmDriverGetWdfDriverHandle
Zwraca uchwyt do obiektu sterownika w ramach struktury, który jest skojarzony z określonym obiektem sterownika WDM.

Uzyskiwanie informacji o żądaniach wejścia/wyjścia w programie WDM

Aby uzyskać informacje o żądaniach we/wy w modelu WDM, sterownik może wywołać następujące metody:

WdfRequestWdmGetIrp
Zwraca strukturę WDM IRP skojarzoną z określonym obiektem żądania. (Z drugiej strony sterownik, który odbiera protokół IRP WDM poza platformą, może utworzyć obiekt żądania struktury dla protokołu IRP przez wywołanie funkcji WdfRequestCreateFromIrp).

WdfRequestGetParameters
Pobiera parametry skojarzone z określonym obiektem żądania platformy. Większość tych parametrów pochodzi z lokalizacji stosu wejścia/wyjścia WDM żądania.

WdfRequestRetrieveOutputWdmMdl
Pobiera listę deskryptora pamięci (MDL), która reprezentuje bufor wyjściowy żądania we/wy.

WdfRequestRetrieveInputWdmMdl
Pobiera plik MDL reprezentujący bufor wejściowy żądania we/wy.

WdfRequestFormatRequestUsingCurrentType
Kopiuje zawartość lokalizacji stosu I/O sterownika wywołującego do lokalizacji stosu I/O lokalnego obiektu docelowego sterownika.

WdfRequestWdmFormatUsingStackLocation
Ustawia zawartość stosu I/O dla lokalnego celu I/O sterownika.

Uzyskiwanie informacji o celach wejścia/wyjścia w WDM

Aby uzyskać informacje o obiektach we/wy w modelu WDM, sterownik może wywołać następujące metody:

WdfIoTargetWdmGetTargetDeviceObject
Zwraca wskaźnik do obiektu urządzenia WDM skojarzonego z lokalnym lub zdalnym celem we/wy.

WdfIoTargetWdmGetTargetFileObject
Zwraca wskaźnik do struktury FILE_OBJECT WDM skojarzonej ze zdalnym celem we/wy.

WdfIoTargetWdmGetTargetFileHandle
Zwraca dojście do pliku skojarzonego z zdalnym obiektem docelowym we/wy.

WdfIoTargetWdmGetTargetPhysicalDevice
Zwraca wskaźnik do obiektu fizycznego urządzenia WDM (PDO), który reprezentuje zdalne urządzenie docelowe we/wy.

Uzyskiwanie informacji o przerwaniach i DPC w WDM

Aby uzyskać informacje o WDM dotyczące przerwań i wywołań procedury odroczonej (DPC), sterownik może wywołać następujące metody:

WdfInterruptWdmGetInterrupt
Zwraca wskaźnik do struktury WDM KINTERRUPT skojarzonej z określonym obiektem przerwania frameworku.

WdfDpcWdmGetDpc
Zwraca wskaźnik do struktury KDPC WDM skojarzonej z określonym obiektem DPC platformy.

Uzyskiwanie informacji o celach I/O USB

Aby uzyskać informacje WDM o celach we/wy USB, sterownik może wywołać następującą metodę:

WdfUsbTargetPipeWdmGetPipeHandle
Zwraca uchwyt typu USBD_PIPE_HANDLE, który jest skojarzony z określonym obiektem potoku frameworku.

Uzyskiwanie informacji o rejestrze WDM

Aby uzyskać informacje o rejestrze WDM, sterownik może wywołać następującą metodę:

WdfRegistryWdmGetHandle
Zwraca dojście WDM do klucza rejestru reprezentowanego przez obiekt registry-key platformy.

Uzyskiwanie informacji o obiektach plików WDM

Aby uzyskać informacje o obiektach plików WDM, sterownik może wywołać następującą metodę:

WdfFileObjectWdmGetFileObject
Zwraca strukturę FILE_OBJECT WDM skojarzoną z określonym obiektem pliku struktury.