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

Структура 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

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

Close

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

Process

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

Reset

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

SetDataFormat

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

SetDeviceState

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

Connect

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

Disconnect

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

Clock

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

Allocator

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

Комментарии

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

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

Требования

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

См. также раздел

KSALLOCATOR_DISPATCH

KSCLOCK_DISPATCH

KSPIN

KsCompletePendingRequest