Metodo IKsDeviceFunctions::RegisterAdapterObjectEx (ks.h)

Articolo
02/26/2024

Il metodo IKsDeviceFunctions::RegisterAdapterObjectEx registra un oggetto adattatore DMA con AVStream. Tutti i driver compilati per le piattaforme Win64 devono usare questo metodo anziché KsDeviceRegisterAdapterObject.

Sintassi

NTSTATUS RegisterAdapterObjectEx(
  [in] PADAPTER_OBJECT     AdapterObject,
  [in] PDEVICE_DESCRIPTION DeviceDescription,
  [in] ULONG               NumberOfMapRegisters,
  [in] ULONG               MaxMappingsByteCount,
  [in] ULONG               MappingTableStride
);

Parametri

[in] AdapterObject

Puntatore al ADAPTER_OBJECT per il dispositivo. Deve essere acquisito tramite IoGetDmaAdapter prima di chiamare RegisterAdapterObjectEx.

[in] DeviceDescription

Puntatore a una struttura di tipo DEVICE_DESCRIPTION che descrive gli attributi del dispositivo fisico per cui il chiamante registra un oggetto DMA.

[in] NumberOfMapRegisters

Specifica il numero di registri mappa restituiti dalla chiamata del minidriver a IoGetDmaAdapter.

[in] MaxMappingsByteCount

Specifica il numero massimo di byte che il dispositivo può gestire per un singolo mapping. Consente ad AVStream di suddividere automaticamente blocchi di grandi dimensioni di memoria fisica contigua in più elementi a dispersione/raccolta per i dispositivi che impongono un limite di dimensioni per i singoli mapping nei trasferimenti DMA. Vedere informazioni importanti su MaxMappingsByteCount nella pagina di riferimento KsDeviceRegisterAdapterObject .

[in] MappingTableStride

Specifica il numero di byte necessari per ogni voce della tabella di mapping. Questo valore deve essere almeno sizeof (KSMAPPING) e può essere il più grande necessario.

Lo spazio aggiuntivo può essere usato dal minidriver come informazioni di contesto.

Valore restituito

RegisterAdapterObjectEx restituisce STATUS_SUCCESS se l'oggetto DMA è stato registrato correttamente. Il metodo restituisce STATUS_INSUFFICIENT_RESOURCES se non è disponibile memoria sufficiente.

Commenti

Vedere anche Supporto di DMA nei driver AVStream a 64 bit.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows Server 2003 con Service Pack 1 (SP1) e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	ks.h (include Ks.h)

Vedi anche

KsDeviceRegisterAdapterObject

Condividi tramite