структура KSPIN_DISPATCH (ks.h)

Статья
02/07/2025

Структура KSPIN_DISPATCH описывает обратные вызовы, для которых клиенты могут регистрироваться для получения уведомлений о событиях пин-кода.

Синтаксис

typedef struct _KSPIN_DISPATCH {
  PFNKSPINIRP                Create;
  PFNKSPINIRP                Close;
  PFNKSPIN                   Process;
  PFNKSPINVOID               Reset;
  PFNKSPINSETDATAFORMAT      SetDataFormat;
  PFNKSPINSETDEVICESTATE     SetDeviceState;
  PFNKSPIN                   Connect;
  PFNKSPINVOID               Disconnect;
  const KSCLOCK_DISPATCH     *Clock;
  const KSALLOCATOR_DISPATCH *Allocator;
} KSPIN_DISPATCH, *PKSPIN_DISPATCH;

Члены

Create

Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniPinCreate. Необязательный. Может быть значение NULL.

Close

Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniPinClose. Необязательный. Может быть значение NULL.

Process

Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniPinProcess. Необязательный. Может быть значение NULL.

Reset

Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniPinRe set. Необязательный. Может быть значение NULL.

SetDataFormat

Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniPinSetDataFormat. Необязательный. Может быть значение NULL.

SetDeviceState

Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniPinSetDeviceState. Необязательный. Может быть значение NULL.

Connect

Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniPinConnect. Необязательный. Может быть значение NULL.

Disconnect

Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniPinDisconnect. Необязательный. Может быть значение NULL.

Clock

Указатель на структуру KSCLOCK_DISPATCH. Укажите этот элемент для пин-кода, предоставляющего часы. Необязательный. Может быть значение NULL.

Allocator

Указатель на структуру KSALLOCATOR_DISPATCH. Укажите этот элемент для пин-кода, который может выполнять выделение на уровне ядра. Необязательный. Может быть значение NULL.

Замечания

Любой из указателей обратного вызова может быть null, указывая, что мини-driver не требует получения уведомлений для этой конкретной отправки.

Если мини-driver должен определить, было ли сигнально перейти к определенному состоянию (например, KSSTATE_RUN), сравнивая значение элемента DeviceStateKS PIN KSSTATE_RUN не является надежным методом этого. DeviceState относится к состоянию, к которому был сигнален пин-код, а не канал. Чтобы обеспечить надежную работу выше, создайте переменную в SetDeviceState обратном вызове этой структуры, а затем проверьте эту переменную, чтобы сделать определение.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Операционных системах Microsoft Windows XP и более поздних версиях, а также в Microsoft DirectX 8.0 и более поздних версиях.
заголовка	ks.h (include Ks.h)

См. также

KSALLOCATOR_DISPATCH

KSCLOCK_DISPATCH

KSPIN

KsCompletePendingRequest

Поделиться через