Funzione KsCreateDevice (ks.h)
La funzione KsCreateDevice crea un dispositivo AVStream.
Sintassi
KSDDKAPI NTSTATUS KsCreateDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor,
[in] ULONG ExtensionSize,
[out, optional] PKSDEVICE *Device
);
Parametri
[in] DriverObject
Puntatore all'oggetto driver WDM del minidriver.
[in] PhysicalDeviceObject
Puntatore all'oggetto dispositivo fisico WDM per il dispositivo che si vuole creare in AVStream.
[in, optional] Descriptor
Puntatore a un descrittore del dispositivo che descrive le caratteristiche del dispositivo creato. Se il chiamante non specifica questo parametro facoltativo, AVStream crea un dispositivo con caratteristiche predefinite e nessun filtro factory associato.
[in] ExtensionSize
Questo parametro contiene le dimensioni dell'estensione del dispositivo. Se si tratta di zero, viene usata la dimensione dell'estensione predefinita. In caso contrario, deve essere almeno sizeof (KSDEVICE_HEADER).
[out, optional] Device
Puntatore a una posizione di memoria contenente l'indirizzo della struttura KSDEVICE creata. facoltativo.
Valore restituito
Restituisce STATUS_SUCCESS se il dispositivo viene creato correttamente. In caso contrario, restituisce un codice di errore appropriato.
Commenti
Normalmente, il minidriver non chiama direttamente questa funzione. KsCreateDevice viene invece chiamato dal gestore predefinito AddDevice, KsAddDevice. Poiché KsAddDevice effettua una chiamata interna a KsCreateDevice, i driver che chiamano KsCreateDevice non devono chiamare KsAddDevice separatamente.
Un minidriver che chiama KsCreateDevice direttamente non deve usare KsInitializeDriver. Se il minidriver non chiama KsInitializeDriver, deve invece fornire il callback addDevice . Il minidriver può quindi chiamare KsCreateDevice da tale callback AddDevice .
Se non viene fornita alcuna KSDEVICE_DESCRIPTOR , AVStream crea un dispositivo con le caratteristiche predefinite e nessuna factory di filtri associata. Se viene fornito un KSDEVICE_DESCRIPTOR e contiene una tabella KSDEVICE_DISPATCH con un invio di creazione, viene chiamato il messaggio di creazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
| Piattaforma di destinazione | Universale |
| Intestazione | ks.h (include Ks.h) |
| Libreria | Ks.lib |
| IRQL | PASSIVE_LEVEL |