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

Vedi anche

DEVICE_OBJECT

DRIVER_OBJECT

KSDEVICE

KSDEVICE_DESCRIPTOR

KSDEVICE_DISPATCH

KsAddDevice

KsInitializeDevice

KsInitializeDriver